YunoHost-Apps/my_webapp_ynh
1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/my_webapp_ynh.git synced 2024-09-03 19:46:26 +02:00
Code Issues Activity Actions

Merge pull request #32 from alexAubin/patch-1

Browse source 
Update README
This commit is contained in:
Maniack Crudelis 2019-02-16 11:46:16 +01:00 • committed by GitHub
commit ddcf06a309
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 44 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

51
README.md
View file

@ -6,55 +6,18 @@ Empty application with SFTP access to the Web directory.
## Overview
This application allows you to easily install a custom Web application,
providing files access with SFTP. It can also create a MySQL database -
providing files access with [SFTP](https://yunohost.org/#/filezilla). It can also create a MySQL database -
which will be backed up and restored with your application. The connection
details will be stored in the file `db_accesss.txt` located in the root
directory.
Once installed, go to the chosen URL to know the user, domain and port
you will have to use for the SFTP access - the password is one you give
at the installation. Under the Web directory, you will see a `www` folder
which is the public and served one. You can put all the files of your
custom Web application inside.
**Once installed, go to the chosen URL to know the user, domain and port
you will have to use for the SFTP access.** The password is one you chosen
during the installation. 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.
## Upgrade
Due to the SFTP access change, the upgrade can not be done from the last
`my_webapp` application - provided with YunoHost 2.2. You will have to remove
it first and install this new one, taking care of migrating your data.
### Save your files and the database
You will have to save the content of the `/var/www/my_webapp/files`
directory, either from the Web admin interface provided by the old app or
connecting to your server using SSH - or SFTP as `admin`.
If you've created a MySQL database, you can also migrate it since the new
version allows to manage it for you. To create a dump, you could either use
[phpMyAdmin](https://github.com/YunoHost-Apps/phpmyadmin_ynh) or connect to
your server and execute:
`mysqldump -u root -p$(cat /etc/yunohost/mysql --no-create-db "$dbname" > ./dump.sql`
(do not forget to replace `$dbname` by your database name).
### Restore your custom Webapp
When you've taken care of saving your files - and optionally your database,
you can remove the app and install this new one. You can set the same
settings as the previous installation.
To restore your files, connect to the Web directory using the SFTP account - as
described at the installation path - and put everything into the `www` directory.
If you have chosen to migrate your database too, open the file `db_access.txt`
to know the new database, user and password you will have to set in your app
configuration. You can restore the dump you've created earlier either using
[phpMyAdmin](https://github.com/YunoHost-Apps/phpmyadmin_ynh) or connect to
your server and execute:
`mysql -u "$dbuser" -p"$dbpass" "$dbname" < ./dump.sql`
(do not forget to replace `$dbuser`, `$dbpass` and `$dbname` with the values
given in the file).
### SFTP port ###
### SFTP port
You may have change the SSH port as described
[here (section "Modifier le port SSH"](https://yunohost.org/#/security_fr) ;