diff --git a/README.md b/README.md index 6467555..d8ef989 100644 --- a/README.md +++ b/README.md @@ -1,134 +1,145 @@  

Write Freely


Latest release Go Report Card Build status #writefreely on freenode

  WriteFreely is a beautifully pared-down blogging platform that's simple on the surface, yet powerful underneath. It's designed to be flexible and share your writing widely, so it's built around plain text and can publish to the _fediverse_ via ActivityPub. It's easy to install and light enough to run on a Raspberry Pi. **[Start a blog on our instance](https://write.as/new/blog/federated)** [Try the editor](https://write.as/new) [Find another instance](https://writefreely.org/instances) ## Features * Start a blog for yourself, or host a community of writers * Form larger federated networks, and interact over modern protocols like ActivityPub * Write on a dead-simple, distraction-free and super fast editor * Publish drafts and let others proofread them by sharing a private link * Build more advanced apps and extensions with the [well-documented API](https://developers.write.as/docs/api/) ## Quick start > **Note** this is currently alpha software. We're quickly moving out of this v0.x stage, but while we're in it, there are no guarantees that this is ready for production use. First, download the [latest release](https://github.com/writeas/writefreely/releases/latest) for your OS. It includes everything you need to start your blog. Now extract the files from the archive, change into the directory, and do the following steps: ```bash # 1) Log into MySQL and run: # CREATE DATABASE writefreely; # # 2) Configure your blog ./writefreely --config # 3) Import the schema with: ./writefreely --init-db # 4) Generate data encryption keys ./writefreely --gen-keys # 5) Run ./writefreely # 6) Check out your site at the URL you specified in the setup process # 7) There is no Step 7, you're done! ``` For running in production, [see our guide](https://writefreely.org/start#production). ## Development Ready to hack on your site? Here's a quick overview. ### Prerequisites * [Go 1.10+](https://golang.org/dl/) * [Node.js](https://nodejs.org/en/download/) ### Setting up ```bash go get github.com/writeas/writefreely/cmd/writefreely ``` Configure your site, create your database, and import the schema [as shown above](#quick-start). Then generate the remaining files you'll need: ```bash make install # Generates encryption keys; installs LESS compiler make ui # Generates CSS (run this whenever you update your styles) make run # Runs the application ``` ## Docker ### Using Docker for Development If you'd like to use Docker as a base for working on a site's styles and such, you can run the following from a Bash shell. *Note: This process is intended only for working on site styling. If you'd like to run Write Freely in production as a Docker service, it'll require a little more work.* The `docker-setup.sh` script will present you with a few questions to set up your dev instance. You can hit enter for most of them, except for "Admin username" and "Admin password." You'll probably have to wait a few seconds after running `docker-compose up -d` for the Docker services to come up before running the bash script. ``` docker-compose up -d ./docker-setup.sh ``` Now you should be able to navigate to http://localhost:8080 and start working! When you're completely done working, you can run `docker-compose down` to destroy your virtual environment, including your database data. Otherwise, `docker-compose stop` will shut down your environment without destroying your data. ### Using Docker for Production -Write Freely doesn't yet provide an official Docker pathway to production. We're -working on it, though! +A Docker image is available at [`writeas/writefreely`](https://hub.docker.com/r/writeas/writefreely/); you can use it with the included +[`docker-compose.yml`](https://github.com/writeas/writefreely/blob/master/docker-compose.yml). + +To setup the compose environment, +1. Modify a copy of [`config.ini.docker-compose`](https://github.com/writeas/writefreely/blob/master/config.ini.docker-compose) and +put it in the same directory as your `docker-compose.yml`. Edit it as appropriate (the database configuration is already setup for the compose file). +2. Modify the `docker-compose.yml` file with a secure mysql password. Make the `config.ini.docker-compose` database patchword match. +3. Run `docker-compose run --rm web /bin/sh` to get a shell inside a running instance of the web container. +5. Run `bin/writefreely -init-db` to setup the database. +6. Run `bin/writefreely -gen-keys` to setup your instance-specific keys. +7. Run `exit` to exit and remove the container. +8. Run `docker-compose up -d` to launch the server. +9. Point your browser to http://localhost:8080 (or whatever URL you set up) to test your instance. ## Contributing We gladly welcome contributions to WriteFreely, whether in the form of [code](https://github.com/writeas/writefreely/blob/master/CONTRIBUTING.md#contributing-to-writefreely), [bug reports](https://github.com/writeas/writefreely/issues/new?template=bug_report.md), [feature requests](https://discuss.write.as/c/feedback/feature-requests), [translations](https://poeditor.com/join/project/TIZ6HFRFdE), or documentation improvements. Before contributing anything, please read our [Contributing Guide](https://github.com/writeas/writefreely/blob/master/CONTRIBUTING.md#contributing-to-writefreely). It describes the correct channels for submitting contributions and any potential requirements. ## License Licensed under the AGPL. diff --git a/config.ini.docker-compose b/config.ini.docker-compose new file mode 100644 index 0000000..06b9282 --- /dev/null +++ b/config.ini.docker-compose @@ -0,0 +1,28 @@ +[server] +hidden_host = 0.0.0.0 +port = 8080 +tls_cert_path = +tls_key_path = + +[database] +type = mysql +username = root +password = changeme +database = writefreely +host = db +port = 3306 + +[app] +site_name = Write Freely Example Blog! +host = http://localhost:8080 +theme = write +disable_js = false +webfonts = true +single_user = true +open_registration = false +min_username_len = 3 +max_blogs = 1 +federation = true +public_stats = true +private = false + diff --git a/docker-compose.yml b/docker-compose.yml index 29a841e..be12d05 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -1,32 +1,31 @@ version: "3" services: web: - build: . + image: "writeas/writefreely" volumes: - - "web-data:/go/src/app" - - "./config.ini.example:/go/src/app/config.ini" + - "web-data:/go/keys" + - "./config.ini.docker-compose:/go/config.ini" ports: - "8080:8080" networks: - writefreely depends_on: - db restart: unless-stopped db: image: "mariadb:latest" volumes: - - "./schema.sql:/tmp/schema.sql" - db-data:/var/lib/mysql/data networks: - writefreely environment: - MYSQL_DATABASE=writefreely - MYSQL_ROOT_PASSWORD=changeme restart: unless-stopped volumes: web-data: db-data: networks: writefreely: