aboutsummaryrefslogtreecommitdiffstats
path: root/INTERNAL_SERVER.md
blob: fcf8cf6af2d768473d49e3b086bcce2b922d524e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
<p align="center">
    <img src="./src/internal-server/public/images/logo.png" alt="" width="300"/>
</p>

# ferdium-internal-server
Internal Ferdium Server used for storing settings/preferences without logging into an external server.

## Differences to ferdium-server
- Doesn't contain user management (only one user)
- Doesn't require logging in
- No recipe creation
- Contains `start.js` script to allow starting the server via script
- Uses `env.ini` instead of `.env` to stay compatible with Ferdium's build script
- Only allows Ferdium clients to connect to the API

## Configuration
ferdium-internal-server's configuration is saved inside the `env.ini` file. Besides AdonisJS's settings, `ferdium-internal-server` has the following custom settings:
- `CONNECT_WITH_FRANZ` (`true` or `false`, default: `true`): Whether to enable connections to the Franz server. By enabling this option, `ferdium-internal-server` can:
  - Show the full Franz/Ferdi recipe library instead of only custom recipes
  - Import Franz/Ferdi accounts

## Importing your Franz/Ferdi account
`ferdium-internal-server` allows you to import your full Franz account, including all its settings.

To import your Franz/Ferdi account, within Ferdium, click on `Help > Import/Export Configuration Data` which will open the running server page in your browser. You can then login using your Franz account details. `ferdium-internal-server` will create a new user with the same credentials and copy your Franz settings, services and workspaces.

## Note For previous contributors
For anyone who has _previously_ setup Ferdium for development, you will need to unregister the `src/internal-server` from being tracked as a git submodule. You can do this by following the steps outlined [here](https://www.w3docs.com/snippets/git/how-to-remove-a-git-submodule.html)