Skip to main content
Apache aliases let you map a URL path to any folder on your system without moving the folder into the www/ directory. For example, you can make http://localhost/myalias/ serve files from D:\projects\myapp\ — useful for projects you keep outside the Bearsampp directory tree.

Aliases vs. virtual hosts

AliasesVirtual hosts
URL formathttp://localhost/myalias/http://myapp.local/
Hosts file change neededNoYes
SSL certificateNo (uses localhost)Yes (auto-generated)
Best forQuickly exposing a folder under localhostSeparate domain per project
Use aliases when you want a quick path under localhost. Use virtual hosts when you need a realistic separate domain. See Virtual Hosts for the latter.

How to add an alias

1

Right-click the Bearsampp tray icon

Find the Bearsampp icon in your Windows system tray and right-click it.
2

Open the Apache menu

Hover over Apache in the context menu.
3

Click Add an alias

Click Add an alias. A dialog opens with two fields.
4

Enter the alias name

In the Name field, type the alias name you want to use. This becomes the URL path segment — for example, entering myalias makes the alias available at http://localhost/myalias/.The name must be alphanumeric (letters and numbers only, no spaces, hyphens, or dots).
5

Set the destination folder

Click Browse next to the Destination field and select the folder you want the alias to point to.
6

Click Save

Click Save. Bearsampp creates the alias configuration file and restarts Apache automatically.
The alias name must contain only letters and numbers. Names with hyphens, underscores, spaces, or dots are not valid and will be rejected.

What Bearsampp creates

When you save an alias, Bearsampp creates a configuration file at:
bearsampp\alias\myalias.conf
This file contains an Apache Alias directive pointing http://localhost/myalias/ to the folder you selected. Apache is restarted automatically to load the new alias.

Accessing your alias

After saving, open your browser and navigate to:
http://localhost/myalias/
Replace myalias with the name you chose. No hosts file changes are needed — aliases work under localhost without any additional configuration.

Edit an alias

1

Open the Apache menu

Right-click the tray icon and hover over Apache.
2

Click Edit [aliasname]

In the Aliases submenu, click the alias you want to edit. The edit dialog opens, pre-filled with the current name and destination.
3

Make your changes and save

Update the alias name or destination folder, then click Save. Apache restarts to apply the change.

Delete an alias

1

Open the Apache menu

Right-click the tray icon and hover over Apache.
2

Click Edit [aliasname]

Open the edit dialog for the alias you want to remove.
3

Click Delete

Click Delete and confirm. Bearsampp removes bearsampp\alias\aliasname.conf and restarts Apache.
Deleting an alias only removes the Apache configuration file. The destination folder and its contents are not affected.