Amahi Wiki - User contributions [en]

Hosting a website

2010-02-21T01:37:17Z

Nordge1: I was very confussed whe I tried this tutorial so I add to it to clarify for noobs like me. Added how to find your conf file and what the file should look like when you're done

You want to run a web server in your Amahi server and make it visible from the web outside your home.

'''FIRST: making anything visible outside your network can open security issues, so you are doing this at your own risk. Some apps are more secure than others, but there is nothing ultimately secure. Best is to use the [[VPN]] to login back home."

With that out of the way, to host your own web site you need the following:

* Forward a port to your HDA ip address, either for plain insecure http: 80, for https, 443 (advanced users can use other ports). Some routers call this or require a "virtual server"
* Chose a domain name that you own (or your free username.yourhda.com that comes with Amahi). This is how the app will be accessed outside
* Chose the app you want to make accessible outside, let's say, '''yourwebappname'''

What you need to do (as root) is find for apps conf file then edit the conf file for the app:

ls /etc/httpd/conf.d

Find your app .conf file. It will look like 10##-yourwebappname.conf

nano /etc/httpd/conf.d/10##-'''yourwebappname'''.conf

Your conf file should look something like this at the top of the page:

<VirtualHost *:80>

ServerName app
ServerAlias app.YourDomain.lan

Add this (immediately after the ServerName directive):

ServerAlias username.yourhda.com

So it looks like this:

<VirtualHost *:80>

ServerName app
ServerAlias app.YourDomain.lan
ServerAlias username.yourhda.com

You can add more server aliases if you want to access the app under those names. Then save the file, quit the editor (nano in this case) and restart the server:

service httpd reload

== FAQs ==

* Q: Do i need to do anything for <code>username.yourhda.com</code> to work?
No. That comes free and automatically set up with your Amahi HDA

* Q: What if i want to do it for a .html or .php file?
You can do this by creating a Webapp of your own. In the apps tab,
select Webapps and create a new one.
What you do is, create a web app, and put the files into the root
directory of the webap, something like this directory:

/var/hda/web-apps/'''yourwebappname'''/html

this directory belongs to apache. you will have to change the
ownership to your user (recommended) or otherwise add things as root.
* Q: How do I change the ownership?
You can do this by going to the command screen:

su -
{password}
chown {user} /var/hda/web-apps/

File:Simpleinvoicesthumb.jpg

2010-02-13T18:01:23Z

Nordge1: Simpleinvoicesthumb.jpg

Simpleinvoicesthumb.jpg

File:Simpleinvoicesscreenshot.jpg

2010-02-13T18:00:08Z

Nordge1: Simpleinvoicesscreenshot.jpg

Simpleinvoicesscreenshot.jpg

SharingToNAS

2010-01-03T07:41:12Z

Nordge1: Changed HDA_username and HDA_password to NAS_username and NAS_password

== Store you HDA shares on a NAS ==
I like to keep my mass storage on a NAS, but I want the stock shares on my HDA to work as designed. the following is my method for mounting my NAS share as my "/var/hda/files" directory. I chose that spot for convenience but you can put it anywhere you would like. I used the "Connecting to a Server by Mounting your HDA" as a template so the credit has to go to it's author. Here we go...

Everthing I did below is done in putty from a cli interface, Install download putty and enter you hda name or address in the address line. Login as root or "su -".

* We need to create a credential file to mount on startup:
<code>sudo nano /root/.smbcredentials</code>
*Add the following lines:
(You must change NAS_username and NAS_password to the correct user name and password for the NAS to connect to):

<code>username=NAS_username<\code>
<code>password=NAS_password<\code>

* Save the file by hitting ctrl+x, type "y" to save the buffer, and <enter> to exit.
* Now, change the permissions of the file so only root can read and edit it:

<code>sudo chmod 700 /root/.smbcredentials</code>

* Let's back up our fstab: sudo cp /etc/fstab /etc/fstab_old
** If needed you may return to the original this way:
<code>sudo mv /etc/fstab_old /etc/fstab</code>
* Now we edit fstab:

<code>sudo nano /etc/fstab</code>

* Add this line at the end:

//server/share /var/hda/files/music cifs credentials=/root
/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

* Finally, test your settings to make sure they work:

<code>sudo mount -a</code>

SharingToNAS

2009-12-30T07:44:50Z

Nordge1: fixed share paths

== Store you HDA shares on a NAS ==
I like to keep my mass storage on a NAS, but I want the stock shares on my HDA to work as designed. the following is my method for mounting my NAS share as my "/var/hda/files" directory. I chose that spot for convenience but you can put it anywhere you would like. I used the "Connecting to a Server by Mounting your HDA" as a template so the credit has to go to it's author. Here we go...

Everthing I did below is done in putty from a cli interface, Install download putty and enter you hda name or address in the address line. Login as root or "su -".

* We need to create a credential file to mount on startup:
<code>sudo nano /root/.smbcredentials</code>
*Add the following lines:
(You must change hda_username and hda_password to the correct user name and password for the NAS to connect to):

<code>
username=hda_username
password=hda_password
<\code>

* Save the file by hitting ctrl+x, type "y" to save the buffer, and <enter> to exit.
* Now, change the permissions of the file so only root can read and edit it:

<code>sudo chmod 700 /root/.smbcredentials</code>

* Let's back up our fstab: sudo cp /etc/fstab /etc/fstab_old
** If needed you may return to the original this way:
<code>sudo mv /etc/fstab_old /etc/fstab</code>
* Now we edit fstab:

<code>sudo nano /etc/fstab</code>

* Add this line at the end:

//server/share /var/hda/files/music cifs credentials=/root
/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

* Finally, test your settings to make sure they work:

<code>sudo mount -a</code>

SharingToNAS

2009-08-18T13:25:08Z

Nordge1:

== Store you HDA shares on a NAS ==
I like to keep my mass storage on a NAS, but I want the stock shares on my HDA to work as designed. the following is my method for mounting my NAS share as my "/var/hda/files" directory. I chose that spot for convenience but you can put it anywhere you would like. I used the "Connecting to a Server by Mounting your HDA" as a template so the credit has to go to it's author. Here we go...

Everthing I did below is done in putty from a cli interface, Install download putty and enter you hda name or address in the address line. Login as root or "su -".

* We need to create a credential file to mount on startup:
<code>sudo nano /root/.smbcredentials</code>
*Add the following lines:
(You must change hda_username and hda_password to the correct user name and password for the NAS to connect to):

username=hda_username
password=hda_password

* Save the file by hitting ctrl+x, type "y" to save the buffer, and <enter> to exit.
* Now, change the permissions of the file so only root can read and edit it:

<code>sudo chmod 700 /root/.smbcredentials</code>

* Let's back up our fstab: sudo cp /etc/fstab /etc/fstab_old
** If needed you may return to the original this way:
<code>sudo mv /etc/fstab_old /etc/fstab</code>
* Now we edit fstab:

<code>sudo nano /etc/fstab</code>

* Add this line at the end:

//hda/music /media/music cifs credentials=/root
/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

* Finally, test your settings to make sure they work:

<code>sudo mount -a</code>

SharingToNAS

2009-08-18T13:24:21Z

Nordge1:

== Store you HDA shares on a NAS ==
I like to keep my mass storage on a NAS, but I want the stock shares on my HDA to work as designed. the following is my method for mounting my NAS share as my "/var/hda/files" directory. I chose that spot for convenience but you can put it anywhere you would like. I used the "Connecting to a Server by Mounting your HDA" as a template so the credit has to go to it's author. Here we go...

Everthing I did below is done in putty from a cli interface, Install download putty and enter you hda name or address in the address line. Login as root or "su -".

* We need to create a credential file to mount on startup:
<code>sudo nano /root/.smbcredentials</code>
*Add the following lines:
(You must change hda_username and hda_password to the correct user name and password for the NAS to connect to):

<code>username=hda_username</code>
<code>password=hda_password</code>

* Save the file by hitting ctrl+x, type "y" to save the buffer, and <enter> to exit.
* Now, change the permissions of the file so only root can read and edit it:

<code>sudo chmod 700 /root/.smbcredentials</code>

* Let's back up our fstab: sudo cp /etc/fstab /etc/fstab_old
** If needed you may return to the original this way:
<code>sudo mv /etc/fstab_old /etc/fstab</code>
* Now we edit fstab:

<code>sudo nano /etc/fstab</code>

* Add this line at the end:

//hda/music /media/music cifs credentials=/root
/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

* Finally, test your settings to make sure they work:

<code>sudo mount -a</code>

SharingToNAS

2009-08-02T18:39:16Z

Nordge1:

== Store you HDA shares on a NAS ==
I like to keep my mass storage on a NAS, but I want the stock shares on my HDA to work as designed. the following is my method for mounting my NAS share as my "/var/hda/files" directory. I chose that spot for convenience but you can put it anywhere you would like. I used the "Connecting to a Server by Mounting your HDA" as a template so the credit has to go to it's author. Here we go...

Everthing I did below is done in putty from a cli interface, Install download putty and enter you hda name or address in the address line. Login as root or "su -".

* We need to create a credential file to mount on startup:
<code>sudo nano /root/.smbcredentials</code>
*Add the following lines:
(You must change hda_username and hda_password to the correct user name and password for the NAS to connect to):

<code>username=hda_username
password=hda_password</code>

* Save the file by hitting ctrl+x, type "y" to save the buffer, and <enter> to exit.
* Now, change the permissions of the file so only root can read and edit it:

<code>sudo chmod 700 /root/.smbcredentials</code>

* Let's back up our fstab: sudo cp /etc/fstab /etc/fstab_old
** If needed you may return to the original this way:
<code>sudo mv /etc/fstab_old /etc/fstab</code>
* Now we edit fstab:

<code>sudo nano /etc/fstab</code>

* Add this line at the end:

//hda/music /media/music cifs credentials=/root
/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

* Finally, test your settings to make sure they work:

<code>sudo mount -a</code>

SharingToNAS

2009-08-02T18:35:17Z

Nordge1:

== Store you HDA shares on a NAS ==
I like to keep my mass storage on a NAS, but I want the stock shares on my HDA to work as designed. the following is my method for mounting my NAS share as my "/var/hda/files" directory. I chose that spot for convenience but you can put it anywhere you would like. I used the "Connecting to a Server by Mounting your HDA" as a template so the credit has to go to it's author. Here we go...

Everthing I did below is done in putty from a cli interface, Install download putty and enter you hda name or address in the address line. Login as root or "su -".

* We need to create a credential file to mount on startup:
sudo nano /root/.smbcredentials
*Add the following lines: (You must change hda_username and hda_password to the correct user name and password for the hda to connect to):

username=hda_username
password=hda_password

* Save the file by hitting ctrl+x, type "y" to save the buffer, and <enter> to exit.
* Now, change the permissions of the file so only root can read and edit it:

sudo chmod 700 /root/.smbcredentials

* Let's back up our fstab:
sudo cp /etc/fstab /etc/fstab_old
* If needed you may return to the original this way:
sudo mv /etc/fstab_old /etc/fstab
* Now we edit fstab:

sudo nano /etc/fstab

* Add this line at the end:

//NAS-address/share /var/hda/files cifs credentials=/root/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

* Finally, test your settings to make sure they work:

sudo mount -a

SharingToNAS

2009-08-02T18:31:29Z

Nordge1:

== Store you HDA shares on a NAS ==
I like to keep my mass storage on a NAS, but I want the stock shares on my HDA to work as designed. the following is my method for mounting my NAS share as my "/var/hda/files" directory. I chose that spot for convenience but you can put it anywhere you would like. I used the "Connecting to a Server by Mounting your HDA" as a template so the credit has to go to it's author. Here we go...

Everthing I did below is done in putty from a cli interface, Install download putty and enter you hda name or address in the address line. Login as root or "su -".

* We need to create a credential file to mount on startup: sudo nano /root/.smbcredentials
*Add the following lines: (You must change hda_username and hda_password to the correct user name and password for the hda to connect to):

username=hda_username
password=hda_password

* Save the file by hitting ctrl+x, type "y" to save the buffer, and <enter> to exit.
* Now, change the permissions of the file so only root can read and edit it:

sudo chmod 700 /root/.smbcredentials

* Let's back up our fstab: sudo cp /etc/fstab /etc/fstab_old
* If needed you may return to the original this way: sudo mv /etc/fstab_old /etc/fstab
* Now we edit fstab:

sudo nano /etc/fstab

* Add this line at the end:

//hda/music /media/music cifs credentials=/root/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

* Finally, test your settings to make sure they work:

sudo mount -a

SharingToNAS

2009-08-02T18:26:12Z

Nordge1:

== Store you HDA shares on a NAS ==
I like to keep my mass storage on a NAS, but I want the stock shares on my HDA to work as designed. the following is my method for mounting my NAS share as my "/var/hda/files" directory. I chose that spot for convenience but you can put it anywhere you would like. I used the "Connecting to a Server by Mounting your HDA" as a template so the credit has to go to it's author. Here we go...

Everthing I did below is done in putty from a cli interface, Install download putty and enter you hda name or address in the address line. Login as root or "su -".

* We need to create a credential file to mount on startup: sudo nano /root/.smbcredentials
*Add the following lines: (You must change hda_username and hda_password to the correct user name and password for the hda to connect to):

username=hda_username
password=hda_password

* Save the file by hitting ctrl+x, type "y" to save the buffer, and <enter> to exit.
* Now, change the permissions of the file so only root can read and edit it:

sudo chmod 700 /root/.smbcredentials

* Let's back up our fstab: sudo cp /etc/fstab /etc/fstab_old
o If needed you may return to the original this way: sudo mv /etc/fstab_old /etc/fstab
* Now we edit fstab:

sudo nano /etc/fstab

* Add this line at the end:

//hda/music /media/music cifs credentials=/root/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

* Finally, test your settings to make sure they work:

sudo mount -a

SharingToNAS

2009-08-02T18:24:10Z

Nordge1:

== Store you HDA shares on a NAS ==
I like to keep my mass storage on a NAS, but I want the stock shares on my HDA to work as designed. the following is my method for mounting my NAS share as my "/var/hda/files" directory. I chose that spot for convenience but you can put it anywhere you would like. I used the "Connecting to a Server by Mounting your HDA" as a template so the credit has to go to it's author. Here we go...

* We need to create a credential file to mount on startup: sudo nano /root/.smbcredentials
*Add the following lines: (You must change hda_username and hda_password to the correct user name and password for the hda to connect to):

username=hda_username
password=hda_password

* Save the file by hitting ctrl+x, type "y" to save the buffer, and <enter> to exit.
* Now, change the permissions of the file so only root can read and edit it:

sudo chmod 700 /root/.smbcredentials

* Let's back up our fstab: sudo cp /etc/fstab /etc/fstab_old
o If needed you may return to the original this way: sudo mv /etc/fstab_old /etc/fstab
* Now we edit fstab:

sudo nano /etc/fstab

* Add this line at the end:

//hda/music /media/music cifs credentials=/root/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

* Finally, test your settings to make sure they work:

sudo mount -a

SharingToNAS

2009-08-02T18:21:41Z

Nordge1:

== Store you HDA shares on a NAS ==
I like to keep my mass storage on a NAS, but I want the stock shares on my HDA to work as designed. the following is my method for mounting my NAS share as my "/var/hda/files" directory. I chose that spot for convenience but you can put it anywhere you would like. I used the "Connecting to a Server by Mounting your HDA"
as a template so the credit has to go to it's author. Here we go...

* We need to create a credential file to mount on startup: sudo nano /root/.smbcredentials
o Add the following lines: (You must change hda_username and hda_password to the correct user name and password for the hda to connect to):

username=hda_username
password=hda_password

* Save the file by hitting ctrl+x, type "y" to save the buffer, and <enter> to exit.
* Now, change the permissions of the file so only root can read and edit it:

sudo chmod 700 /root/.smbcredentials

* Let's back up our fstab: sudo cp /etc/fstab /etc/fstab_old
o If needed you may return to the original this way: sudo mv /etc/fstab_old /etc/fstab
* Now we edit fstab:

sudo nano /etc/fstab

* Add this line at the end:

//hda/music /media/music cifs credentials=/root/.smbcredentials,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0

* Finally, test your settings to make sure they work:

sudo mount -a