Actualizar 'README.md'

Add more extended guideline for configuring the project.
This commit is contained in:
Bofh 2022-12-10 07:30:31 +00:00
parent 12f7213eee
commit 428d380311
1 changed files with 29 additions and 6 deletions

View File

@ -6,16 +6,39 @@ In short: manage your ActivityPub implementation software (ex: Mastodon) in a ne
<br>
## Installation (Standalone)
## Installation
The project uses only these 4 languages: PHP, HTML, CSS, JS. You have this basic requirements:
The project is a web application, therefore it uses only these 4 languages: **PHP**, **HTML**, **CSS**, **JS**.
- A **standalone web server** with any **PHP** version you want.
- Make sure the **web server has access** to your Mastodon/Pixelfed (or whatever) web, database, redis... (depending on the instance managed and configured in the web interface).
### First steps
First of all, read this basic guideline of requirements:
- You need any **standalone web server** with any **PHP** version you can/want (also see the "Package requirements" below).
- Make sure the **web server has access** to your Mastodon/Pixelfed (or whatever): web (via HTTP), database (via IP:PORT), redis (via IP:PORT)... (the needed services to be accessed, depends on the instance managed and configured in the web interface).
- **No need for any database** for saving this web application's data: instance configuration, manager users, jobs... It is saved in common files.
- Copy **config/application.php.example** to **config/application.php** and modify it to your needs.
- For **background jobs**, you only need to run the cron.php script with **php cron.php** or **php /your/deployed/path/cron.php** in any way you want. Also the interval to run this job can be anyone you want (1 minute, 5 minutes or even more...). (The recommended setting is to run every minute).
### Package requirements
This requirements are specified with their common names, adapt the package name to your needs (version, operating system...):
This requirements are specified with their common names, **adapt the package names** to your needs (version, operating system...):
- php-pqsql (Postgres)
- php-curl (Curl)
## About Versioning
All tags are created from a moment of the "main" branch. There can be alpha- or beta- prefixes to a version, but all prefixes have there own numeration.
Version numeration is representad as this examples: `v1.2.0, alpha-v1.0.0, beta-v3.0.2`. In this example `v1.2.0` is higher than any alpha- or beta- numeration, as this prefixes are only used as a state of development of this web application.
## Updates
Just do a `git pull` and `git checkout THEVERSION`
<br>
## Contributing
You can send patches, code in any format you want, or suggestions to the email bofh@nogafam.es