Find a file
liamwhite 5b1812cb6f
Merge pull request from mdashlw/custom-fields-range-error
Return error if range is specified for custom fields
2025-04-14 11:20:10 -04:00
.githooks Add better logs to repo init script 2025-03-29 15:01:09 +00:00
.github Make sure repo init script works on CI 2025-03-23 04:41:34 +00:00
.vscode Remove PostCSS Vscode extension recommendation as it seems to be unmaintained and it removes some CSS intellisense 2025-03-24 16:17:23 +00:00
assets Bump vite in /assets 2025-04-11 15:47:48 +00:00
config Apply npm run fmt across the entire codebase 2025-03-16 23:26:36 +00:00
docker Remove now useless COPY instructions because we use a volume bind-mount instead 2025-04-06 01:51:12 +00:00
lib Merge pull request from mdashlw/custom-fields-range-error 2025-04-14 11:20:10 -04:00
native/philomena Bump zip from 2.2.1 to 2.3.0 in /native/philomena 2025-03-18 00:11:41 +00:00
priv Apply npm run fmt across the entire codebase 2025-03-16 23:26:36 +00:00
scripts Resolve the real path when invoking philomena.sh to remove some intermediate .. in error messages that feature the script path 2025-04-06 20:43:27 +00:00
test Add version 4 TypeScript-based FP calculation 2024-06-13 10:24:39 -04:00
.credo.exs Fix some credo issues 2024-06-24 23:23:43 -04:00
.dialyzer_ignore.exs Force GH Actions workflows to use test env 2025-01-11 13:42:31 -05:00
.dockerignore Use custom prebuilt ffmpeg 2021-12-12 13:43:22 -05:00
.editorconfig Add switch_case_ident to .editorconfig to fix the defaults of shfmt (facehoof) 2025-04-06 20:03:27 +00:00
.formatter.exs initial 2019-08-14 20:32:32 -04:00
.gitattributes Shorten the comment 2025-03-23 04:35:11 +00:00
.gitignore Use a * in gitignore because git add complains about changing the ignored file 2025-03-24 16:17:53 +00:00
.iex.exs run formatter 2020-01-10 23:20:19 -05:00
.prettierrc.yml Apply npm run fmt across the entire codebase 2025-03-16 23:26:36 +00:00
.sobelow-conf add and configure sobelow 2021-04-01 12:49:41 -04:00
.typos.toml Fix typos lint 2025-03-17 23:24:31 +00:00
docker-compose.yml bump software versions 2025-04-04 09:25:09 +02:00
LICENSE add totp & registration freeze 2019-08-17 18:06:11 -04:00
mix.exs Dependency update 2025-03-12 12:12:13 -04:00
mix.lock Dependency update 2025-03-12 12:12:13 -04:00
package-lock.json Remove the deprecated eslint and stylelint prettier plugins. Move prettier to the top level 2025-03-16 23:19:58 +00:00
package.json Add prettier to CI 2025-03-17 03:04:18 +00:00
post-receive add release conf for performing migrations 2020-08-17 18:49:44 -04:00
README.md Remove the Updates section from README, will return to it in the PR for shellcheck installation when tooling is moved to docker 2025-04-06 20:57:49 +00:00

Philomena

Philomena

Getting Started

Make sure you have Docker and Docker Compose plugin installed.

Add the directory scripts/path to your PATH to get the philomena dev CLI globally available in your terminal. For example you can add the following to your shell's .*rc file, but adjust the path to philomena repo accordingly.

export PATH="$PATH:$HOME/dev/philomena/scripts/path"

Use the following commands to bring up or shut down a dev server.

philomena up
philomena down

Once the application has started, navigate to http://localhost:8080 and login with

Credential Value
Email admin@example.com
Password philomena123

Tip

See the source code of scripts/philomena.sh for details on the additional parameters and other subcommands.

Pre-commit hook

Run the following command to configure the git pre-commit hook that will auto-format the code and run lightweight checks on each commit.

philomena init

IDE Setup

If you are using VSCode, you are encouraged to install the recommended extensions that VSCode should automatically suggest to you based on .vscode/extensions.json file in this repo.

Troubleshooting

If you are running Docker on Windows and the application crashes immediately upon startup, please ensure that autocrlf is set to false in your Git config, and then re-clone the repository. Additionally, it is recommended that you allocate at least 4GB of RAM to your Docker VM.

If you run into an OpenSearch bootstrap error, you may need to increase your max_map_count on the host as follows:

sudo sysctl -w vm.max_map_count=262144

If you have SELinux enforcing (Fedora, Arch, others; manifests as a Could not find a Mix.Project error), you should run the following in the application directory on the host before proceeding:

chcon -Rt svirt_sandbox_file_t .

This allows Docker or Podman to bind mount the application directory into the containers.

If you are using a platform which uses cgroups v2 by default (Fedora 31+), use podman and podman-compose.

Deployment

You need a key installed on the server you target, and the git remote installed in your ssh configuration.

git remote add production philomena@<serverip>:philomena/

The general syntax is:

git push production master

And if everything goes wrong:

git reset HEAD^ --hard
git push -f production master

(to be repeated until it works again)