9c6143df27
This adds:
- Two entries in the manifest:
- A choice for the NodeJS version
- A port (provisionned in any case due to ynh limitations, but this should not matter)
- Services and configs:
- Systemctl configs to run the NodeJS server
- A watcher service and path to restart NodeJS upon file update
- A custom NGinx config because it is incompatible with the default one
- Docs:
- More info in the description and admin
The install/remove/backup/restore have been adapted and tested.
The upgrade script is updated but not tested
The change_url script does not change
It is not possible to have both PHP and NodeJS to keep the scripts simple.
35 lines
1.9 KiB
Markdown
35 lines
1.9 KiB
Markdown
This app is simply a blank web app skeleton : you are expected to add you own content (HTML, CSS, PHP, ...) inside `__INSTALL_DIR__/www/`. One way to do so is by using SFTP.
|
|
|
|
### Login using SFTP
|
|
|
|
Once installed, go to the chosen URL to know the username, domain and port you will have to use for the SFTP access.
|
|
|
|
- Host: `__DOMAIN__`
|
|
- Username: `__ID__`
|
|
- Password: password chosen during installation
|
|
- Port: 22 (unless you changed the SSH port)
|
|
|
|
To connect, you'll need an SFTP app such as [Filezilla](https://filezilla-project.org/) for Windows, Mac or Linux. You can also use your default file manager on [Mac](https://support.apple.com/guide/mac-help/connect-mac-shared-computers-servers-mchlp1140/mac) or Linux.
|
|
|
|
#### Forgot your SFTP password?
|
|
|
|
If you forgot your SFTP password, you can change it in YunoHost's webadmin interface in `Apps > My webapp > My Webapp configuration`.
|
|
You can also check there that SFTP is enabled.
|
|
|
|
### Login using the command line
|
|
|
|
Starting YunoHost v11.1.21, you can run `sudo yunohost app shell __APP__` in the command line interface to log in as your app user.
|
|
|
|
The `php` command will point to the PHP version installed for the app.
|
|
|
|
### Adding or editing files
|
|
|
|
Once logged in, under the Web directory you will see a `www` folder which contains the public files served by this app. You can put all the files of your custom Web application inside.
|
|
|
|
### Customizing the nginx configuration
|
|
|
|
If you want to add tweak the nginx configuration for this app, it is recommended to edit `/etc/nginx/conf.d/__DOMAIN__.d/__ID__.d/WHATEVER_NAME.conf` (ensure that the file has the `.conf` extension) and reload the nginx after making sure that the configuration is valid using `nginx -t`.
|
|
|
|
### Listening the right port for NodeJS
|
|
|
|
The listen port is available to the node process throught the environment variable `PORT`. Make sure that your main `.js` file retrieves it with `process.env.PORT` as its value is not predictable.
|