1 # Pleroma: A lightweight social networking server
2 # Copyright © 2017-2018 Pleroma Authors <https://pleroma.social/>
3 # SPDX-License-Identifier: AGPL-3.0-only
5 defmodule Mix.Tasks.Pleroma.Instance do
7 alias Mix.Tasks.Pleroma.Common
9 @shortdoc "Manages Pleroma instance"
11 Manages Pleroma instance.
13 ## Generate a new instance config.
15 mix pleroma.instance gen [OPTION...]
17 If any options are left unspecified, you will be prompted interactively
21 - `-f`, `--force` - overwrite any output files
22 - `-o PATH`, `--output PATH` - the output file for the generated configuration
23 - `--output-psql PATH` - the output file for the generated PostgreSQL setup
24 - `--domain DOMAIN` - the domain of your instance
25 - `--instance-name INSTANCE_NAME` - the name of your instance
26 - `--admin-email ADMIN_EMAIL` - the email address of the instance admin
27 - `--dbhost HOSTNAME` - the hostname of the PostgreSQL database to use
28 - `--dbname DBNAME` - the name of the database to use
29 - `--dbuser DBUSER` - the user (aka role) to use for the database connection
30 - `--dbpass DBPASS` - the password to use for the database connection
33 def run(["gen" | rest]) do
42 instance_name: :string,
56 [config_path, psql_path] = [
57 Keyword.get(options, :output, "config/generated_config.exs"),
58 Keyword.get(options, :output_psql, "config/setup_db.psql")
61 will_overwrite = Enum.filter(paths, &File.exists?/1)
62 proceed? = Enum.empty?(will_overwrite) or Keyword.get(options, :force, false)
64 unless not proceed? do
70 "What domain will your instance use? (e.g pleroma.soykaf.com)"
79 "What is the name of your instance? (e.g. Pleroma/Soykaf)"
82 email = Common.get_option(options, :admin_email, "What is your admin email address?")
85 Common.get_option(options, :dbhost, "What is the hostname of your database?", "localhost")
88 Common.get_option(options, :dbname, "What is the name of your database?", "pleroma_dev")
94 "What is the user used to connect to your database?",
102 "What is the password used to connect to your database?",
103 :crypto.strong_rand_bytes(64) |> Base.encode64() |> binary_part(0, 64),
107 secret = :crypto.strong_rand_bytes(64) |> Base.encode64() |> binary_part(0, 64)
108 {web_push_public_key, web_push_private_key} = :crypto.generate_key(:ecdh, :prime256v1)
112 "sample_config.eex" |> Path.expand(__DIR__),
121 version: Pleroma.Mixfile.project() |> Keyword.get(:version),
123 web_push_public_key: Base.url_encode64(web_push_public_key, padding: false),
124 web_push_private_key: Base.url_encode64(web_push_private_key, padding: false)
129 "sample_psql.eex" |> Path.expand(__DIR__),
136 "Writing config to #{config_path}. You should rename it to config/prod.secret.exs or config/dev.secret.exs."
139 File.write(config_path, result_config)
140 Mix.shell().info("Writing #{psql_path}.")
141 File.write(psql_path, result_psql)
147 1. Verify the contents of the generated files.
148 2. Run `sudo -u postgres psql -f #{Common.escape_sh_path(psql_path)}`.
150 if config_path in ["config/dev.secret.exs", "config/prod.secret.exs"] do
153 "3. Run `mv #{Common.escape_sh_path(config_path)} 'config/prod.secret.exs'`."
158 "The task would have overwritten the following files:\n" <>
159 (Enum.map(paths, &"- #{&1}\n") |> Enum.join("")) <>
160 "Rerun with `--force` to overwrite them."