How to create a subdomain pointing to a file/subdirectory with ISPConfig

Discussion in 'Tips/Tricks/Mods' started by R_O, Mar 31, 2019.

  1. R_O

    R_O New Member


    I need to create subdomains to point files and subdirectories:

    1. pointing to < /public_html/subdomain/ >.

    2. file, pointin to < /public_html/file.php >.

    I would prefer to automate the process with an script instead of making it one by one but I would appreciate your help to make it in any of the two ways.

    Thank you
  2. Jesse Norell

    Jesse Norell ISPConfig Developer Staff Member ISPConfig Developer

    Ensure you have 'Create subdomains as web site' enabled under System > Main Config > Sites

    With the aforementioned setting enabled, this is exactly what happens when you add a 'Subdomain (Vhost)' (you specify the subdomain name, path to web folder, and other settings).

    If using apache, change the DirectoryIndex for this subdomain to be (or to include) 'file.php'. I'm not as familiar with nginx, but I believe you have to specify a config section which accomplishes that.

    You can use the remote api to script the creation of websites, subdomains, etc. Set up at least one manually in the ISPConfig interface first so you can reference what goes into each of the db tables (which correspond to the fields in the remote api).
  3. R_O

    R_O New Member

    I guess this solution uses a directory but I need a subdomain without it, only a file like this < /public_html/file.php > not < /public_html/subdomain/file.php >

    Instead, please let me know how to modify the files where ISPconfig defines pointing < /public_html/subdomain/ >, to replace "subdomain" for "file.php". I do not know how ISPConfig makes that configuration and what files are involved.

    Thank you for your help
    Last edited: Apr 2, 2019
  4. nhybgtvfr

    nhybgtvfr Active Member

    just set the redirect path to /public_html
    that should set the subdomain to use exactly the same webroot as the main domain.
    then in the vhost configuration for this subdomain, set 'DirectoryIndex file.php'
    i assume this can be set in the apache directives section on the options tab for the website, but it's not a directive i've tried setting before, so can't confirm that.
  5. R_O

    R_O New Member

    I do not know what to enter in [Subdomain for website / Redirect Path ] to point </public_html>.

    I neither know how to make DirectoryIndex to open </public_html/file1.php> when <> is requested and </public_html/file2.php> when <> does.

    I also wonder what does "redirect type" means, I did not find it in the documentation <>
    Last edited: Apr 2, 2019
  6. till

    till Super Moderator Staff Member ISPConfig Developer

    ISPconfig manual, page 138.
    Richard Foley likes this.
  7. nhybgtvfr

    nhybgtvfr Active Member

    we're just using /public_html as that's what you used in your initial example.

    if the full path to your main domain's docroot is /var/www/clients/client1/web1/web
    then with a subdomain vhost, the parent website will be the main domain, the domain will be the same, hostname will be the subdomain. the web folder will be /web

    for a subdomain pointing to a subfolder on the main site, parent website and domain would be the main domain, host would be the subdomain, redirect path would be /web/<path>/<to>/<subfolder>

    this page has more info on the redirects

    you would probably be better off buying the ispconfig manual for £5, the stuff your looking at on looks rather sparse compared to the manual.
  8. R_O

    R_O New Member

    I have the manual and now I understand the flags concept. Thank you very much.

    I have two doubts yet:
    1. What to enter in [Subdomain for website / Redirect Path ] to point </public_html>. The examples are made for directories inside the host, this way the name of the subdomain is entered in the field, but What if there is no directory? Do you have to use a wild card, let it blank...?
    2. How to make DirectoryIndex to open </public_html/file1.php> when <> is requested; </public_html/file2.php> when <> does, and the same with </public_html/file3.php> and <>. My experience with DirectoryIndex is seting <index.html>, <index.shtml>, etc. to open when their directory is requested, they are sorted as are listed in the file,. In this case <index.html> will open with <> and <> always. Let me know if there is an additional configuration in DirectoryIndex to get what I need.
  9. nhybgtvfr

    nhybgtvfr Active Member

    1. there will be a directory. if your main domain is and your subdomain is
    the docroot for will be /var/www/clients/client##/web##/web/
    if you wanted the subdomain to point to a subfolder of the main domain, eg
    the redirect path for the subdomain would be /web/subfolder1/subfolder2
    if you want the subdomain to point to the same docroot as the main domain, the redirect path would just be /web
    for the same examples, as a vhost subdomain, parent website and domain would be, host would be sub, and webfolder would be /web/subfolder1/subfolder2, or for the same docroot as the main domain, just /web

    2. if you want the subdomain to point to a file you would set the redirect path to<filename> or<subfolder>/<filename> if the file was within a subfolder on the main domain.
    or you create a vhost subdomain as above, and in the apache directives section set the directive:
    DirectoryIndex <filename>
    it will only apply within that vhost / subdomain. if there's still more subfolders within the subdomain eg where subfolder1 contains file1.php and subfolder2 contains index.php the set it as
    DirectoryIndex file1.php index.php
    for the vhost subdomain you would set it as DirectoryIndex file2.php
    and for vhost, DirectoryIndex file3.php itself will continue to use the default DirectoryIndex settings
  10. nhybgtvfr

    nhybgtvfr Active Member

    actually, just double checked that, for a subdomain the redirect path would just be /subfolder1/subfolder2
    you can't set it to use the same docroot as the main domain. you'd have to do it as a vhost subdomain
    (you could add the whole subdomain as an alias and then redirect that, but that's probably more complication that you need, especially if domain limits are enabled)
  11. R_O

    R_O New Member

    If I understand well, there the ISPConfig screen named [Subdomain for website] can not make a subdomain to point a file because its field named [Redirect Path] can not point to the folder </public_html> (this can only point to </public_html/subdomain> for <>) In other words such screen only makes subdomains redirected to subfolders.

    If this is the case, I am back to my original answer What shall I need to do for creating a subdomain pointing to a file in a server with ISPConfig?
  12. nhybgtvfr

    nhybgtvfr Active Member

    create a vhost subdomain, pointing to the relevant folder. which would be /public_html according to your initial examples.
    AND set the 'DirectoryIndex file.php' apache directive
  13. R_O

    R_O New Member

    DirectoryIndex, as explained in its documentation <>, can not do what I need:
    <> opens </public_html/file1.php>
    <> opens </public_html/file2.php>
    <> opens </public_html/file3.php>
    <> opens </public_html/fileN.php>

    Instead, unless you provide the code, it does:
    <> opens </public_html/file1.php>
    <> opens </public_html/file1.php>
    <> opens </public_html/file1.php>

    I thought this would be a simple task with ISPConfig, but per your valuable contributions it seems such can not create the subdomain, neither the redirect to make <> opens </public_html/file1.php>. There must be something we are not considering.
    Last edited: Apr 3, 2019
  14. till

    till Super Moderator Staff Member ISPConfig Developer

    You probably need:

    1) A website in ispconfig with auto subdomain set to *
    2) An apache rewrite rule, e.g. in a .htaccess file or in the apache directives field which uses the subdomain as a variable:

    RewriteCond %{HTTP_HOST} ^(.+)
    RewriteRule .* [L,P]

    The above is untested and might need some further tuning, it's just a suggestion which route you could go.

    I recommend the apache rewrite documentation for reading: and
  15. R_O

    R_O New Member

    I guess the * must be entered at [Subdomain for website / Redirect Path] field.

    Is it the .htaccess in the <> </public_html/> folder to override the instruction of the VHOST file made in the step 1)?
  16. till

    till Super Moderator Staff Member ISPConfig Developer

    No, auto subdomain is a field in the website settings and there you select *.

    The .htaccess file is in the web folder and it is not there to override any settings from 1).
  17. R_O

    R_O New Member

    Thank you Till, you are the soul of this forum.
    Once I make it work I own you a beer.
  18. R_O

    R_O New Member

    Till, here I am again.
    May you help me with the information to make the same with Nginx (+ISPConfig 3).
    I found making it in Apache is time consuming for me and for the server.
    It seems Nginx is better because all the adjustments are made in a single file, but:
    1. I do not know how to create the subdomain in ISPConfig+Nginx Is it the same than in Apache?
    2. Where is the server file with the domain blocks or there is a different approach to make what I need.

    Thank you
  19. Taleman

    Taleman Well-Known Member HowtoForge Supporter

    It is the same.
    This I do not know. I have only used Apache, I find Nginx too complicated and difficult.
  20. Richard Foley

    Richard Foley Member

    I think you'll find your nginx configuration under Sites->Website->Web_Domain->Options->nginx_directives


Share This Page