Configurando Plume

Si está usando PostgreSQL, tiene que crear una base de datos para Plume.

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

Antes de iniciar Plume,’necesitará crear un archivo de configuración, llamado .env. Este archivo debe estar en el mismo directorio que el en el que iniciarás Plume (~/Plume, si haz seguido las instrucciones anteriores). Si está instalando desde el código fuente, puede utilizar cp .env.sample .env para generarlo. Aquí hay un ejemplo de lo que debería poner dentro para sistemas GNU/Linux y Mac OS X.

# The address of the database
# (replace USER, PASSWORD, PORT and DATABASE_NAME with your values)
#
# If you are using SQlite, use the full path of the database file (`plume.db` for instance)
# Windows user's paths are backslashes, change them to forward slashes
#DATABASE_URL=/etc/path/to/Plume/plume.db
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

Para más información sobre lo que puede poner en su .env, vea la documentación sobre variables del entorno.

Now we need to run migrations. Las migraciones son scripts usados para actualizar la base de datos. To run the migrations, you can do for GNU/Linux and Mac OS X:

plm migration run

If you are using Windows and DATABASE of sqlite, you will need to copy the sqlite3.dll from “C:\ProgramData\chocolatey\lib\SQLite\tools” to where plm.exe and plume.exe were compiled: copy "C:\ProgramData\chocolatey\lib\SQLite\tools\sqlite3.dll" "C:\Users\%USERNAME%\.cargo\bin\sqlite3.dll"

Ahora puedes ejecutar las migraciones: plm migration run

Las migraciones deben ejecutarse después de cada actualización. When in doubt, run them.

También necesitará inicializar el índice de búsqueda:

plm search init

Después de eso,’necesitarás configurar tu instancia y la cuenta de administrador’s.

plm instance new
plm users new --admin

Note if you want to use LDAP: you should still create an administrator account, at least to give admin rights to your own LDAP account once it’s registered.

En Windows, puede haber un error al crear el usuario administrador. Para evitar esto, necesitas ejecutar: plm users new --admin -n "adminusername" -N "Human Readable Admin Name" -b "Biografía de Admin aquí" -p hackmeplease

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

Ahora que Plume está configurado, si estás en un entorno de producción probablemente quieras configurar tu sistema de inicio para que sea más fácil de gestionar.

Configure init system