You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
documentation/source/installation/config.html.md

2.0 KiB

title
Configuring Plume

If you are using PostgreSQL, you have to create a database for Plume.

service postgresql start
su - postgres
createuser -d -P plume
createdb -O plume plume

Before starting Plume, you'll need to create a configuration file, called .env. Here is a sample of what you should put inside.

# The address of the database
# (replace USER, PASSWORD, PORT and DATABASE_NAME with your values)
#
# If you are using SQlite, use the path of the database file (`plume.db` for instance)
DATABASE_URL=postgres://USER:PASSWORD@IP:PORT/DATABASE_NAME

# For PostgreSQL: migrations/postgres
# For SQlite: migrations/sqlite
MIGRATION_DIRECTORY=migrations/postgres

# The domain on which your instance will be available
BASE_URL=plu.me

# Secret key used for private cookies and CSRF protection
# You can generate one with `openssl rand -base64 32`
ROCKET_SECRET_KEY=

# Mail settings
# If you don't want to setup a mail server and/or address for plume
# and don't plan to use the "password reset" feature,
# you can comment these lines.
MAIL_SERVER=smtp.example.org
MAIL_USER=example
MAIL_PASSWORD=123456
MAIL_HELO_NAME=example.org
MAIL_ADDRESS=from@example.org

For more information about what you can put in your .env, see the documentation about environment variables.

Now we need to run migrations. Migrations are scripts used to update the database. To run the migrations, you can do:

plm migration run

Migrations should be run after each update. When in doubt, run them.

After that, you'll need to setup your instance, and the admin's account.

plm instance new
plm users new --admin

You will also need to initialise search index

plm search init

For more information about these commands, and the arguments you can give them, check out their documentation.

Now that Plume is configured, if you are in a production environment you probably want to configure your init system to make it easier to manage.

Configure init system