How to Convert .htaccess Rewrite Rules to Nginx Config

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

Antihost offers Linux VPS plans with full root access, unlimited traffic on a 1 Gbps port and a 14-day free trial.

Converting an Apache .htaccess file to Nginx is a semantic rewrite, not a line-by-line translation. First identify what each rule does—redirects, internal routing, file checks, access decisions, or backend handoffs—then place equivalent logic in the correct Nginx http, server, or location context.

Use dedicated server blocks with return for canonical-host redirects, try_files for file-or-front-controller routing, regex rewrite only for pattern transformations, and named locations for application proxying. Preserve query strings and redirect status deliberately, then test status codes, Location headers, final URIs, and logs before switching traffic.

#	Preview	Product	Price
1		Compressed Air Duster,130000RPM Super Power Cordless Air Duster,Rechargeable Brushless Blower,3 Gear...	$21.59	Buy on Amazon
2		EVEO® Screen Cleaner Spray Kit (Streak-Free) TV Screen Cleaner for Smart TV, Lcd, LEd, Oled |...	$15.97	Buy on Amazon
3		BladeHawks RGB Gaming Mouse Pad Extra Large Extended 31.5x12 Inch-Black	$14.99	Buy on Amazon
4		Vaydeer Wrist Rest for Keyboard and Mouse, Computer Ergonomic Wrist Support Pad, Soft Memory Foam...	$15.99	Buy on Amazon
5		Under Desk Cable Management Tray No Drill, Metal Mesh Cable Management Under Desk with Clamp Mount,...	$13.99	Buy on Amazon

Why a direct copy of .htaccess usually fails

Apache and Nginx process URL rules in different places. Apache’s RewriteRule has a pattern, substitution, and optional flags. A RewriteCond immediately before it tests an expanded value such as the host, port, query string, or filesystem state. The meaning of the pattern also depends on context.

In Apache server or virtual-host configuration, the rule sees the URL path. In per-directory .htaccess context, Apache removes the directory prefix before matching. A rule in /blog/.htaccess therefore matches article, not /blog/article. Nginx location processing normally works with a URI beginning with /. Copying the expression without accounting for that difference can make a rule miss every request or match a broader path than intended.

#1 Best Overall

Sale

Compressed Air Duster,130000RPM Super Power Cordless Air Duster,Rechargeable Brushless Blower,3 Gear Adjustable Blower with LED Light,Dust Remover for Computer/House/Outdoor/Car

• Powerful Turbo Fan:CAGIWIRU Electric Air Duster have reached speed up to 130000RPM,Can efficient remove dust and debris.With LED light and Three Adjustable Speed to meet with different cleaning tasks.
• With Attached USB C Fasting Charging cable.Charing 3 hours,Enjoy up to 240 minutes of use on the lowest setting, For third speed can use for 25mins.with four charging options to meet with your needs.
• Wide Application:Upgraded attached 5 different nozzles,making it suitable for a variety of scenes, such as car,pet, pc, keyboards, and other electronic devices. It also serves for office and home clean duster.
• Handy Design & Portable:Cordless air duster electric nozzle is Light weight and small size, design and comfortable to hold and space saving, convenient to carry around. You can put it in your room or inside the car without taking up space.
• Warranty & Support: Our Electric air duster comes with 5 years warranty and 24/7 customer service. During this period, if you have any questions,pls kindly feel free to contact us.

$21.59

Buy on Amazon

Apache can discover per-directory files while processing a request. Nginx has no .htaccess mechanism; all behavior must be present in the loaded Nginx configuration. The surrounding document root, index handling, PHP-FPM settings, proxy behavior, and server-name selection must therefore be made explicit.

Inventory the Apache rules before writing Nginx

Do not start by replacing every RewriteRule with a line that looks similar. Export the complete chain, including inherited files and every condition, and record the directory containing each rule. Then classify each rule by outcome.

1. Record the match context. Note whether the original file was in the document root or a subdirectory. Remove or add the directory prefix consciously when creating an Nginx pattern.
2. Write down the observable result. Is the request redirected to another URL, internally mapped to a different URI, served from disk, denied, or sent to PHP-FPM or a proxy?
3. Capture conditions and variables. List tests involving HTTP_HOST, HTTPS, REQUEST_URI, QUERY_STRING, remote addresses, or file existence. Record captures from both the rule and its conditions; Apache uses separate backreference sets.
4. Record status and query-string behavior. A permanent redirect, temporary redirect, and internal rewrite are different contracts. Also note whether the original query string is retained, replaced, or discarded.
5. Mark filesystem assumptions. Identify tests for a real file, directory, maintenance page, index file, or extension variant. These normally belong in try_files, not a long regex chain.
6. Draw the request flow. Show which host receives the request, which location wins, whether a new location search is required, and where the request ultimately ends.

Map each Apache outcome to the right Nginx directive

The following choices prevent most mechanical translation errors.

Convert canonical-host redirects with server blocks

Suppose Apache redirects the bare host to the www host:

RewriteCond %{HTTP_HOST} example.org
RewriteRule (.*) http://www.example.org$1

Place the redirect in its own Nginx server block. This avoids running normal site logic before the redirect and preserves the complete original request URI, including its query string.

server {
    listen 80;
    server_name example.org;
    return 301 http://www.example.org$request_uri;
}

server {
    listen 80;
    server_name www.example.org;
    root /var/www/example.org/current/public;
    index index.html index.php;
    # normal site configuration
}

Use HTTPS names and certificates in the same way when the canonical destination is secure. If both unknown hosts and known aliases must converge on one name, define the canonical host explicitly and add a catch-all:

server {
    listen 80 default_server;
    server_name _;
    return 301 http://www.example.org$request_uri;
}

This converts Apache’s negative condition logic into deterministic server selection. A separate block is easier to audit than combining an Nginx if with a rewrite, and it prevents the redirect rule from being evaluated repeatedly inside the normal location tree.

Convert WordPress and other front-controller rules with try_files

A common Apache file checks whether the request maps to an existing file or directory and otherwise sends it to index.php. The direct Nginx form is:

Rank #2

EVEO® Screen Cleaner Spray Kit (Streak-Free) TV Screen Cleaner for Smart TV, Lcd, LEd, Oled | Computer Screen Cleaner Spray and Wipe Microfiber Cloth - TV, Monitor, Laptop, iPad, Car - 6.7oz 1 Pack

• Screen Cleaner is Your Screen’s New Bestfriend! - EVEO is proud to present a screen cleaner that’s perfectly suited for your TV. Meet your new screen cleaner, computer screen cleaner, laptop cleaner, iPad cleaner, Macbook,tv cleaner or any other electronic device. Our screen cleaner spray and wipe along with the included plush microfiber cloth, easily removes dust, fingerprints & other smudges on the screen’s surface. Clean effectively for a streak-free screen
• Gentle on your Screens - Our screen cleaner spray and wipes is compatible to be used even for the most sensitive LCD, LED, CRT, and OLED screens in proper use. Be at ease knowing that this product is compatible with all the major brands: LG, SONY, Samsung, Sharp, iPad, iPhone, Android screens, Kindle, PC monitors - we’ve got you covered! Can be used as LCD screen cleaner, tv cleaner, smart tv screen cleaner, and more
• Premium Super Soft Plush Microfiber Cloth - Included in this efficient screen cleaning kit. This screen cleaner spray and wipe has our signature plush microfiber cloth specially designed to comply with screens and monitors and leave them streak-free. Has been shown to effectively absorbs stubborn stains, zero streaks, and no fiber shedding. Always use this together with our screen cleaner for the best results
• Easy-to-Use Screen Cleaner Kit + microfiber cleaning cloth - The EVEO Screen Cleaning Kit will easily be your new favorite tool when it comes to taking care of the things you love most, quick and easy solution for a streak-free screen. Simply screw on the sprayer gun on the screen cleaner bottle. Spray the cleaning liquid onto the microfiber cloth, then wipe the screen until desired cleanliness & shine is achieved.
• Quality Screen Care Kit Worth Purchasing - Enjoy a convenient Screen Cleaner anytime, anywhere you need it. Your satisfaction is our top priority. We stand behind the quality of our products and that’s why, you shouldn’t be worrying at all. We manufacture the Best Screen Cleaner. and can be used for laptop cleaning kit, laptop screen cleaner, tv screen cleaner for smart tv. MacBook screen cleaner, monitor cleaner or screen cleaner spray for electronic devices with microfiber cleaning cloth

$15.97

Buy on Amazon

server {
    listen 80;
    server_name www.example.org;
    root /var/www/example.org/current/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }
}

$uri tests the requested path as a file, and $uri/ tests it as a directory. Only when neither exists does Nginx internally route the request to /index.php. The $args suffix carries the original query string to the front controller.

The PHP location must then pass the script to PHP-FPM. Its socket or TCP address is deployment-specific, but the routing relationship should be explicit:

location ~ [.]php$ {
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass unix:/run/php/php-fpm.sock;
}

Restrict execution to the intended document root and use a distribution-appropriate FastCGI include. Do not assume that a file-or-front-controller rule also configures PHP; Nginx requires both pieces.

Express maintenance files and application backends with a named location

When Apache tries a maintenance document, the requested file, an index file, and an extension variant before handing the request to an application cluster, keep those filesystem tests together and send the final branch to a named location:

server {
    listen 80;
    server_name app.example.org;
    root /var/www/myapp.com/current/public;

    location / {
        try_files /system/maintenance.html
                  $uri $uri/index.html $uri.html
                  @app_server_cluster;
    }

    location @app_server_cluster {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://app-server;
    }
}

If /system/maintenance.html exists, it is served first. Otherwise Nginx checks the request path, an index file below that path, and an extension variant. The named location isolates proxy settings from the file tests and avoids a second regex-based routing pass.

In a named location, use a proxy definition that matches the upstream’s expected URI behavior. A proxy target with an unintended URI suffix can strip or replace path segments, so verify the upstream request line in application logs.

Translate regex path transformations carefully

Nginx rewrite directives accept a regular-expression pattern and replacement and execute in order. Captures from the pattern are available as $1, $2, and so on. For example, an old path can be redirected while retaining a captured slug:

server {
    listen 80;
    server_name www.example.org;

    rewrite ^/old/(.*)$ /new/$1 permanent;
}

Use return when no pattern matching is needed. For example:

Rank #3

BladeHawks RGB Gaming Mouse Pad Extra Large Extended 31.5x12 Inch-Black

• 【Large size】：Measuring 800 x 300 mm/ 31. 5×12 inches, which is wider and taller than others. Large mouse pad can perfectly fit your keyboard and mouse of any size, and there is also ample space for peripherals such as phones, tablets, etc.
• 【LED backlight mouse pad】：Blade Hawks RGB mouse pad provides 7 static modes and 7 dynamic modes will give you the options you are looking for. Power-off memory function remembers the last lighting mode you selected. The super glow fiber Chroma will give you a colorful gaming setup that you want.
• 【Anti-slip rubber base】：Made from Natural rubber, this gaming mousepad will firmly grip your desktop, allowing you to enjoy the ultimate precision in the games you are most passionate about. It also comes with a texture that enhances this ability even further.
• 【Smooth and waterproof surface】: Micro-textured cloth surface, for extremely precise mouse control and a smooth movement. When liquid splashes on the gaming mouse pad, it forms water droplets and slides down. Will not delay your work or gameplay.
• 【Plug and play】: This mouse and keyboard pad is powered by USB, plug and play, no driver required. One button control light modes. Press one time to change the lighting mode, press twice to change the brightness, press and hold about 3 seconds turn ON/OFF.

$14.99

Buy on Amazon

return 301 https://www.example.org$request_uri;

That directive communicates an unconditional external redirect directly. Use a regex rewrite only when the path must be transformed. If the original Apache substitution was internal, do not add a redirect flag simply because the old rule used [L].

Be precise about slashes. An Apache rule copied from a document-root .htaccess may have matched old/(.*); in an Nginx location the equivalent pattern usually includes ^/old/(.*)$. Conversely, a rewrite placed in a context where Nginx already supplies the location prefix can become too broad if the prefix is repeated.

Map RewriteCond tests and backreferences

Apache conditions are evaluated before their associated rule and can capture text independently of the rule pattern. Nginx exposes request data through variables, but the equivalent design is often a different configuration structure rather than a literal conditional.

Host and scheme tests

Use server_name to select known hosts. Keep canonical redirects in dedicated blocks. For a scheme redirect, a server listening on the non-secure port can return the secure URL directly:

server {
    listen 80;
    server_name www.example.org;
    return 301 https://www.example.org$request_uri;
}

This is preferable to testing the host and scheme inside every location.

Query-string tests

Nginx provides the raw query string as $args. If a branch depends on a particular parameter, use a narrowly scoped condition or a map in the http context to turn the test into a variable. Keep the resulting branch explicit and document whether the parameter remains in the forwarded request.

Filesystem conditions

Replace tests such as Apache’s -f and -d with try_files. It performs the existence checks in the order written and makes the fallback visible. This is more reliable than reproducing every test with regular expressions.

Negated conditions

For logic such as every host except the canonical host, define the canonical hosts positively and use a default_server catch-all for everything else. Reserve Nginx if for simple, well-understood actions such as an immediate return; do not build a nested rewrite engine from multiple if blocks.

Rank #4

Sale

Vaydeer Wrist Rest for Keyboard and Mouse, Computer Ergonomic Wrist Support Pad, Soft Memory Foam Arm Cushion for Desk, Palm Hand Office Laptop Typing

• 【Softer and More Comfortable】Vaydeer wrist rest has unique diamond pattern, which is the combination of softness and aesthetics. The materials of wrist rest are improved into higher quality memory foam and covered with silky smooth lycra. The computer wrist rest makes you as comfortable and cushiony as like rest your wrists on clouds.
• 【Ergonomic Wrist Saver】The wrist rests for keyboard and mouse comes with a 17.32×3.15×0.83 inch keyboard wrist pad and a 5.94×3.15×0.83 inch mouse wrist support. Based on ergonomic design, the unique concave shape is the perfect fit for your wrist joints. The wrist rest pad fits most computer keyboards and laptops, improve hand and wrist posture, release your wrist and arm stress.
• 【Non-Slip Rubber Bottom】Featuring an anti-skid silicone base on the bottom, this wrist keyboard support stays firmly in place on your desk, preventing the padding from sliding around, ensuring stable and consistent wrist support during extended computer sessions.
• 【Better Experience & Pain Relief】Our keyboard arm rest is beneficial to alleviate the soreness caused by direct contact and friction between your arm and a hard desk surface, reducing the risk of wrist fatigue or carpal tunnel. The soft texture of memory foam can evenly distribute the pressure around your wrists and provide good support with just enough give.
• 【Helpful in Multiple Scenarios】Whether you're working, studying, writing, typing, gaming, this keyboard and mouse rest combo is an essential accessory to add comfort and support to your hands and wrists. It’s also a great gift for men, women, family, friend, coworker, gamer, teacher, etc.

$15.99

Buy on Amazon

Preserve query strings and choose status codes intentionally

An external redirect changes what the client requests next. An internal rewrite changes Nginx’s processing URI while leaving the browser’s address unchanged. Decide which behavior the Apache rule actually produced before selecting a directive.

For an internal rewrite, adding a question mark changes query-string behavior. A replacement ending in ? discards the original arguments; a replacement containing ?new=value replaces them. If the old request’s arguments must survive, append ?$args or use a construct such as $is_args$args when the target should receive a question mark only when arguments exist.

Use 301 only when the move is permanent and tested. During migration, a 302 can prevent browsers and intermediate caches from storing an incorrect destination while you verify the result.

Understand ordering, last, break, and rewrite loops

Nginx processes server-level rewrites, selects a location, then processes location directives. A rewrite with last stops the current rewrite set and starts a new location search. That is useful when the new URI must be handled by a different location, but it can loop if the new URI matches the same rewrite again.

break stops rewrite processing in the current context and keeps the request in that location. It is appropriate when the URI should be changed without re-entering location selection. Neither flag is a mechanical replacement for Apache’s [L]; Apache’s per-directory phases can re-enter rules in ways that do not have a one-to-one Nginx equivalent.

• Put exact or highly specific locations before broad fallbacks, and verify which location Nginx actually selects.
• Keep host redirects at the server level instead of inside the general application location.
• Ensure a rewrite’s destination no longer satisfies its own source pattern, or add an explicit exclusion.
• Use try_files for disk checks so a successful file test ends routing without another regex pass.
• After every internal rewrite, inspect the next location and confirm that the request eventually reaches static content, PHP-FPM, or the intended upstream.

A loop commonly appears after translating every Apache [L] to last. The first pass changes the URI, the new location applies the same rule, and the cycle repeats until Nginx reports an internal redirection problem. Reclassify the rule and choose break, a named location, or a terminating return instead.

A complete migration sequence

Use this order for a real site rather than editing production rules one at a time without a model.

1. Freeze the Apache behavior. Save the active .htaccess chain, including parent files and virtual-host rules. Collect representative requests for every branch.
2. Separate host handling. Create server blocks for canonical names, aliases, HTTP-to-HTTPS moves, and unknown hosts. Use return for redirects.
3. Define the document root and index files. Nginx must know the exact filesystem path that Apache previously inferred.
4. Replace file tests. Convert real-file, directory, maintenance, and extension checks to an ordered try_files list.
5. Add the backend handoff. Use a named proxy location or an explicit PHP-FPM location. Set forwarded headers and verify the upstream path semantics.
6. Translate genuine regex transformations. Include the leading slash required by the Nginx context, preserve captures, and choose permanent, redirect, last, or break according to the intended result.
7. Map remaining conditions. Prefer server selection, map, and try_files. Add a conditional directive only when its evaluation and side effects are clear.
8. Validate syntax before reloading. Run nginx -t. Fix every error before issuing a reload through the service manager.
9. Exercise the test matrix. Check canonical and non-canonical hosts, HTTP and HTTPS, existing files, directories, missing paths, encoded characters, empty and populated query strings, redirects, and backend routes.
10. Compare observable behavior. Record status codes, Location headers, final URIs, response bodies, cache headers, and application logs. A page that appears correct can still be wrong if it returns 200 instead of 301 or silently drops parameters.

Test and troubleshoot the converted configuration

Syntax and reload failures

Run nginx -t against the configuration that the service actually loads. An apparently correct file may be ignored if it is not included, while duplicate server names can send requests to an unexpected block. Confirm the include path and the selected virtual host before debugging a rule.

Best Value

Sale

Under Desk Cable Management Tray No Drill, Metal Mesh Cable Management Under Desk with Clamp Mount, 2 Hole Cable Tray with Wire Management and Cord Organizer for Home Office Standing Desk

• 【No Drill Mounted】Cable management tray can be assembled in as little as 3 minutes or less-simply. Side clips easily clampe the edge of desk, pass through the holes on the sides, and secure excess cables with baskets. Desk cable management supports inward or outward installation to meet your needs in different scenarios, and provides you with great convenience when collecting and organizing wires.
• 【Rubber Pad Protects Desk】Wire organizer under desk built-in soft rubber pads on the clamp protect your desk from scratches, so you will not damage your furniture or office.
• 【Sturdy and Beautiful】Cord management under desk is made of high-quality carbon steel and holds about 15 lbs. The wire basket has 2 holes on each side of the tray to enable your cables to pass freely. Cable baskets are suitable for desk thickness use from 0.4" to 2.4".
• 【Space Saving & Keep Organized】Desk cable management tray holds all your power cords, outlet strips, USB hubs and computer transformers hidden from your feet, and the data cables will not enter the vacuum cleaner to keep your desk clean and tidy. Desk wire organizer is also suitable for use in the kitchen and outdoors.
• 【Reduce Safety Risks】Cable tray under desk keeps all plugs away from your kids, no more worry about tripping. Using 2 holes wire tray saves extra space, helps you easily cabling and wire protection. The mesh design is not easy to accumulate dust, but avoids safety accidents caused by messy wires.

$13.99

Buy on Amazon

Unexpected 404 responses

Check the effective root, the leading slash in the pattern, and whether a directory prefix was removed during Apache per-directory matching. Test the file directly with curl -I, then test the same URI through the application fallback. If the front controller is PHP, confirm that the FastCGI script path resolves to the intended file.

Wrong status code

A browser may hide an incorrect status after following a redirect. Use a request that shows headers, such as curl -sS -D - -o /dev/null http://example.org/path. Verify whether the response is 301, 302, 200, 403, or 404 and whether a Location header is present. Replace an internal rewrite with an explicit return when the client must see a redirect, or remove the redirect flag when the browser URL should remain unchanged.

Lost or duplicated query parameters

Compare requests containing no arguments, one argument, and several arguments. Inspect the upstream access log rather than relying only on the browser. Check every rewrite replacement for an unintended question mark, and use $args where the original query string belongs in the target request.

Redirect loops

Log the host, URI, and scheme at each hop. A canonical-host block may redirect to a name that still selects the non-canonical block, or an internal last rewrite may re-match its own destination. Test each server block independently with an explicit Host header and remove overlapping conditions.

Static files work but application routes fail

Confirm that try_files ends with the correct front controller or named location. Then inspect the PHP-FPM or proxy error log for a wrong script filename, upstream name, port, socket, or forwarded host. A successful static-file test does not prove that the backend branch is configured.

Encoded characters behave differently

Include spaces, percent-encoded slashes where permitted, Unicode paths, and repeated slashes in testing. Compare the URI Nginx logs with the URI Apache previously received. Avoid broad regex rewrites that normalize or decode text unintentionally; let the application receive the same logical path unless a deliberate normalization is required.

Migration checklist

• Complete .htaccess chain exported, including inherited files.
• Directory context recorded for every Apache rule.
• Each rule classified as redirect, internal rewrite, file test, access decision, or backend handoff.
• Canonical hosts represented by dedicated server blocks.
• Unknown-host behavior handled by an intentional default server.
• Existing-file and front-controller routing expressed with try_files.
• Query-string retention or replacement documented for every transformation.
• Apache condition variables mapped to Nginx variables, server selection, map, or a narrowly scoped condition.
• last and break selected for processing flow rather than copied from [L].
• PHP-FPM or proxy path, headers, and upstream address verified.
• nginx -t passes before reload.
• Representative hosts, paths, methods, query strings, encoded characters, status codes, headers, caches, and logs compared with the Apache behavior.

What a successful conversion looks like

The finished configuration should make the request flow obvious: the correct server block receives the host, a specific location handles the URI, existing content is served without unnecessary rewrites, application paths reach exactly one backend handoff, and redirects return the intended status with the intended query string. Treating the migration as a mapping of behavior—not syntax—prevents the most common failures: missing leading slashes, dropped arguments, wrong redirect codes, and rewrite loops.

Quick Recap

SaleBestseller No. 1

Compressed Air Duster,130000RPM Super Power Cordless Air Duster,Rechargeable Brushless Blower,3 Gear Adjustable Blower with LED Light,Dust Remover for Computer/House/Outdoor/Car

$21.59

Bestseller No. 2

EVEO® Screen Cleaner Spray Kit (Streak-Free) TV Screen Cleaner for Smart TV, Lcd, LEd, Oled | Computer Screen Cleaner Spray and Wipe Microfiber Cloth - TV, Monitor, Laptop, iPad, Car - 6.7oz 1 Pack

$15.97

Bestseller No. 3

BladeHawks RGB Gaming Mouse Pad Extra Large Extended 31.5x12 Inch-Black

$14.99

SaleBestseller No. 4

Vaydeer Wrist Rest for Keyboard and Mouse, Computer Ergonomic Wrist Support Pad, Soft Memory Foam Arm Cushion for Desk, Palm Hand Office Laptop Typing

$15.99

SaleBestseller No. 5

Under Desk Cable Management Tray No Drill, Metal Mesh Cable Management Under Desk with Clamp Mount, 2 Hole Cable Tray with Wire Management and Cord Organizer for Home Office Standing Desk

$13.99

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.