---
title: "Deploy Apache Solr | (Just Updated) Search Platform, REST API, Password Auth On, Index Survives Redeploys"
description: "Apache Solr search server with REST API, password auth on, core ready"
category: "Storage"
url: https://railway.com/deploy/apache-solr-or-jus-1
---

# Deploy Apache Solr | (Just Updated) Search Platform, REST API, Password Auth On, Index Survives Redeploys

Apache Solr search server with REST API, password auth on, core ready

**[Deploy Apache Solr | (Just Updated) Search Platform, REST API, Password Auth On, Index Survives Redeploys on Railway](https://railway.com/template/apache-solr-or-jus-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/apache-solr-or-jus-1/manifest.json

- **Creator:** SuperSlowSloth
- **Category:** Storage

## Template content

### solr

- **Image:** solr:10.1.0@sha256:c51416312939159e5b6e8b4eb05efce1fc41e1dd95cb8712aaba64b72f74ee86
- **Start command:** `/bin/sh -c 'echo IyEvYmluL3NoCiMgUmFpbHdheSBib290IGZvciBBcGFjaGUgU29sciAoc3RhbmRhbG9uZSwgb25lIGNvcmUpLiBSdW5zIGFzIHJvb3QsIGRyb3BzIHRvIHRoZSBzb2xyIHVzZXIuCiMKIyBBIHN0b2NrIFNvbHIgY29udGFpbmVyIHNlcnZlcyBpdHMgYWRtaW4gQVBJLCBldmVyeSBjb3JlIGFuZCB0aGUgdXBkYXRlIGhhbmRsZXJzIHRvIGFueQojIGNhbGxlciB0aGF0IGNhbiByZWFjaCBwb3J0IDg5ODMgKG5vIGF1dGhlbnRpY2F0aW9uIHVudGlsIHNlY3VyaXR5Lmpzb24gZXhpc3RzKS4gVGhpcyBzY3JpcHQ6CiMgIC0gd3JpdGVzIGEgQmFzaWNBdXRoICsgcm9sZS1iYXNlZC1hdXRob3JpemF0aW9uIHNlY3VyaXR5Lmpzb24gZnJvbSBTT0xSX1BBU1NXT1JEIG9uIGV2ZXJ5CiMgICAgYm9vdCwgc28gYSBjaGFuZ2VkIHBhc3N3b3JkIHRha2VzIGVmZmVjdCBvbiByZWRlcGxveTsgb25seSB0aGUgaGVhbHRoIGVuZHBvaW50IGlzIG9wZW47CiMgIC0gY2hvd25zIHRoZSByb290LW93bmVkIFJhaWx3YXkgdm9sdW1lIHRvIHVpZCA4OTgzIGFuZCB0aGVuIGRyb3BzIHByaXZpbGVnZXMgd2l0aCBzZXRwcml2LAojICAgIGJlY2F1c2UgU29sciByZWZ1c2VzIHRvIHN0YXJ0IGFzIHJvb3QgYW5kIHRoZSBpbWFnZSBlbnRyeXBvaW50IHdvdWxkIG5vdCBvd24gL3Zhci9zb2xyOwojICAtIHNpemVzIHRoZSBKVk0gaGVhcCBhbmQgcHJvY2Vzc29yIGNvdW50IGZyb20gdGhlIGNncm91cCwgYmVjYXVzZSB0aGUgSlZNIHNpemVzIGJvdGggZnJvbQojICAgIHRoZSBIT1NUIG9uIFJhaWx3YXk7CiMgIC0gbGlzdGVucyBvbiB0aGUgUE9SVCBSYWlsd2F5IGluamVjdHMgKGl0cyBIVFRQIGhlYWx0aGNoZWNrIGRpYWxzIHRoYXQgcG9ydCwgbm90IHRoZQojICAgIGRvbWFpbidzIHRhcmdldCBwb3J0KSBhbmQgb24gYm90aCBJUHY0IGFuZCBJUHY2LCBzbyB0aGUgcHJpdmF0ZSBuZXR3b3JrIHdvcmtzOwojICAtIHByZWNyZWF0ZXMgYSBjb3JlIG5hbWVkICJtYWluIiBmcm9tIHRoZSBfZGVmYXVsdCBjb25maWdzZXQsIG9uY2UgKHNraXBwZWQgd2hlbiBpdCBleGlzdHMpLgpzZXQgLWV1CgpWT0w9L3Zhci9zb2xyCjogIiR7U09MUl9QQVNTV09SRDo/U09MUl9QQVNTV09SRCBtdXN0IGJlIHNldH0iCkNPUkU9bWFpbgoKTT0kKGNhdCAvc3lzL2ZzL2Nncm91cC9tZW1vcnkubWF4IDI+L2Rldi9udWxsIHx8IGVjaG8gbWF4KQpRPSQoY3V0IC1kJyAnIC1mMSAvc3lzL2ZzL2Nncm91cC9jcHUubWF4IDI+L2Rldi9udWxsIHx8IGVjaG8gbWF4KQppZiBbICIkTSIgIT0gbWF4IF0gJiYgWyAiJE0iIC1sdCAxMDAwMDAwMDAwMDAwIF0gMj4vZGV2L251bGw7IHRoZW4KICBNRU1fTUI9JCgoTSAvIDEwNDg1NzYpKQplbHNlCiAgTUVNX01CPSQoYXdrICcvTWVtVG90YWwvIHtwcmludCBpbnQoJDIgLyAxMDI0KX0nIC9wcm9jL21lbWluZm8pCiAgWyAiJE1FTV9NQiIgLWd0IDgxOTIgXSAmJiBNRU1fTUI9ODE5MgpmaQppZiBbICIkUSIgIT0gbWF4IF0gJiYgWyAiJFEiIC1ndCAwIF0gMj4vZGV2L251bGw7IHRoZW4KICBDT1JFUz0kKCggKFEgKyA5OTk5OSkgLyAxMDAwMDAgKSkKZWxzZQogIENPUkVTPSQobnByb2MpCmZpCiMgSGFsZiB0aGUgY29udGFpbmVyIGZvciB0aGUgaGVhcDsgdGhlIHJlc3QgaXMgdGhlIHBhZ2UgY2FjaGUgTHVjZW5lJ3MgbW1hcCByZWFkcyBkZXBlbmQgb24uCkhFQVBfTUI9JCgoTUVNX01CIC8gMikpClsgIiRIRUFQX01CIiAtbHQgMjU2IF0gJiYgSEVBUF9NQj0yNTYKWyAiJEhFQVBfTUIiIC1ndCAxNjM4NCBdICYmIEhFQVBfTUI9MTYzODQKCm1rZGlyIC1wICIkVk9ML2RhdGEiICIkVk9ML2xvZ3MiCgojIHNlY3VyaXR5Lmpzb246IHBhc3N3b3JkIGhhc2ggaXMgYmFzZTY0KHNoYTI1NihzaGEyNTYoc2FsdCB8fCBwYXNzd29yZCkpKSArICIgIiArIGJhc2U2NChzYWx0KS4KU0FMVF9GSUxFPSQobWt0ZW1wKQpvcGVuc3NsIHJhbmQgMzIgPiAiJFNBTFRfRklMRSIKSEFTSD0kKCB7IGNhdCAiJFNBTFRfRklMRSI7IHByaW50ZiAnJXMnICIkU09MUl9QQVNTV09SRCI7IH0gfCBvcGVuc3NsIGRnc3QgLXNoYTI1NiAtYmluYXJ5IHwgb3BlbnNzbCBkZ3N0IC1zaGEyNTYgLWJpbmFyeSB8IGJhc2U2NCAtdzApClNBTFQ9JChiYXNlNjQgLXcwIDwgIiRTQUxUX0ZJTEUiKQpybSAtZiAiJFNBTFRfRklMRSIKY2F0ID4gIiRWT0wvZGF0YS9zZWN1cml0eS5qc29uIiA8PEpTT04KewogICJhdXRoZW50aWNhdGlvbiI6IHsKICAgICJibG9ja1Vua25vd24iOiBmYWxzZSwKICAgICJjbGFzcyI6ICJzb2xyLkJhc2ljQXV0aFBsdWdpbiIsCiAgICAiY3JlZGVudGlhbHMiOiB7ICJhZG1pbiI6ICIkSEFTSCAkU0FMVCIgfSwKICAgICJyZWFsbSI6ICJBcGFjaGUgU29sciIsCiAgICAiZm9yd2FyZENyZWRlbnRpYWxzIjogZmFsc2UKICB9LAogICJhdXRob3JpemF0aW9uIjogewogICAgImNsYXNzIjogInNvbHIuUnVsZUJhc2VkQXV0aG9yaXphdGlvblBsdWdpbiIsCiAgICAicGVybWlzc2lvbnMiOiBbCiAgICAgIHsgIm5hbWUiOiAiaGVhbHRoIiwgInJvbGUiOiBudWxsIH0sCiAgICAgIHsgIm5hbWUiOiAiYWxsIiwgInJvbGUiOiAiYWRtaW4iIH0KICAgIF0sCiAgICAidXNlci1yb2xlIjogeyAiYWRtaW4iOiBbImFkbWluIl0gfQogIH0KfQpKU09OCgpjaG93biAtUiA4OTgzOjg5ODMgIiRWT0wiCmVjaG8gIltyYWlsd2F5XSBzb2xyIHVpZD0kKGlkIC11KSBvd25lcj0kKHN0YXQgLWMgJXU6JWcgIiRWT0wiKSBtZW09JHtNRU1fTUJ9TUIgaGVhcD0ke0hFQVBfTUJ9TUIgY29yZXM9JENPUkVTIHBvcnQ9JHtQT1JUOi04OTgzfSIKCmV4cG9ydCBTT0xSX1BPUlQ9IiR7UE9SVDotODk4M30iIFNPTFJfUE9SVF9MSVNURU49IiR7UE9SVDotODk4M30iCmV4cG9ydCBTT0xSX0hPU1RfQklORD0iOjoiCmV4cG9ydCBTT0xSX0hFQVA9IiR7SEVBUF9NQn1tIgpleHBvcnQgU09MUl9PUFRTPSIke1NPTFJfT1BUUzotfSAtWFg6QWN0aXZlUHJvY2Vzc29yQ291bnQ9JENPUkVTIgpleHBvcnQgU09MUl9MT0dTX0RJUj0iJFZPTC9sb2dzIgoKZXhlYyBzZXRwcml2IC0tcmV1aWQ9ODk4MyAtLXJlZ2lkPTg5ODMgLS1jbGVhci1ncm91cHMgZW52IEhPTUU9IiRWT0wiIGRvY2tlci1lbnRyeXBvaW50LnNoIHNvbHItcHJlY3JlYXRlICIkQ09SRSIK | base64 -d > /tmp/boot.sh; exec /bin/sh /tmp/boot.sh'`
- **Health check:** /solr/
- **Public domain:** Yes

## Documentation

# Deploy and Host Apache Solr on Railway

**Built for an LLM agent to deploy and use.** There is no setup wizard and nothing to fill in: a 32-character admin password is generated at deploy time, a search core named `main` already exists, and every admin, update and query call must present the password. A stock Solr container serves its whole API to anyone who can reach the port; this template switches that off from the first boot. The contract below lists every URL, variable name and the one script that proves it works.

Apache Solr is the open-source Lucene-based search platform: full-text search, faceting, filtering, highlighting, geospatial search and vector search over JSON documents, all through an HTTP API. This template runs Solr in standalone mode, one node, one core.

## About Hosting Apache Solr

This template runs one service, `solr`, built from the official **Apache Solr 10.1.0** image (`solr`, pinned by digest). Upstream's image runs as uid 8983 and Railway mounts the volume root-owned, so a small boot script (embedded in the start command) fixes ownership, drops privileges with `setpriv`, and starts Solr with the stock entrypoint. It also writes `security.json` from the generated password on every boot (BasicAuth plus role-based authorization, so a changed `SOLR_PASSWORD` takes effect on redeploy), sizes the JVM heap to half the container memory limit and the processor count to the container's CPU quota (the JVM otherwise reads the host's), and listens on the port Railway injects, on IPv4 and IPv6. The first boot creates the core `main` from Solr's `_default` configset, which has a managed schema and guesses field types, so you can post JSON documents immediately. Data, configuration and logs live on the volume at `/var/solr` and survive redeploys. The core takes a few seconds to load after the service turns healthy; retry the first call.

### Agent contract

- Public URL: `https://` plus the `RAILWAY_PUBLIC_DOMAIN` of the `solr` service, as `SOLR_PUBLIC_URL`. The API is under `/solr`, the admin UI at `/solr/`.
- Private URL: `http://solr.railway.internal:8080` (variable `SOLR_PRIVATE_URL`), same paths.
- Credentials: user `admin`, password in `SOLR_PASSWORD`.
- Auth: HTTP Basic (`curl -u admin:$SOLR_PASSWORD`). Without credentials every call except health returns 401.
- Health: `GET /solr/admin/info/health` returns 200 with no credentials. Core readiness: `GET /solr/main/admin/ping` with credentials returns 200 once the core `main` is loaded.

```bash
# run with SOLR_PUBLIC_URL and SOLR_PASSWORD set; needs curl
A="admin:$SOLR_PASSWORD"
curl -s -o /dev/null -w 'health %{http_code}\n' "$SOLR_PUBLIC_URL/solr/admin/info/health"
curl -s -o /dev/null -w 'anonymous %{http_code}\n' "$SOLR_PUBLIC_URL/solr/admin/cores"
until curl -fs -o /dev/null -u "$A" "$SOLR_PUBLIC_URL/solr/main/admin/ping"; do sleep 3; done
echo core ready
curl -fsS -u "$A" -H 'Content-Type: application/json' -d '[{"id":"1","title_t":"Solr search on Railway"},{"id":"2","title_t":"Agent memory index"}]' "$SOLR_PUBLIC_URL/solr/main/update?commit=true" | grep -o '"status":0'
curl -fsS -u "$A" -G --data-urlencode "q=title_t:railway" --data-urlencode "fl=id,title_t" "$SOLR_PUBLIC_URL/solr/main/select" | grep -o '"numFound":[0-9]*'
```

A fresh deploy prints `health 200`, `anonymous 401`, `core ready`, `"status":0` and `"numFound":1`. Documents are JSON arrays posted to `/solr/main/update?commit=true`; queries use `/solr/main/select` with `q`, `fq`, `fl`, `sort`, `facet` and `rows`. Create more cores with a GET to `/solr/admin/cores` carrying the query parameters action=CREATE, name (your core name) and configSet=_default, using the same credentials. Official clients (pysolr, SolrJ, solr-client for Node) take the base URL `SOLR_PUBLIC_URL/solr` or `SOLR_PRIVATE_URL/solr` and the user and password.

## Why Deploy Apache Solr on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Apache Solr on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

- **Agent-ready** - generated password, a ready core, contract block and one working script; no setup step.
- **Closed by default** - the admin API, updates and queries all need the password, unlike a stock Solr container.
- **Current release** - Solr 10.1.0, pinned by digest, so a redeploy never changes the server underneath you.
- **Right-sized** - heap and processor count come from the container limits, not from the host.
- **Index survives redeploys** - cores, configuration and index files live on a volume.

## Common Use Cases

- **Site and product search** - full-text search with facets, filters and highlighting over your own documents.
- **Retrieval for AI agents** - keyword and vector search over notes, tickets or documents.
- **Log and catalogue search** - index JSON records and query them over HTTP.

## Dependencies for Apache Solr Hosting

- None. Solr stores its own data on the volume at `/var/solr`.

### Deployment Dependencies

- [apache/solr](https://github.com/apache/solr) - upstream project


## Similar templates

- [RustFS | (Just Updated) S3 Object Store, Public URL and Keys Set](https://railway.com/deploy/rustfs-or-just-updated-s3-object-store-p) — S3-compatible object store, keys and public URL preset, volume kept
- [TimescaleDB](https://railway.com/deploy/timescaledb-railway-template) — A PostgreSQL-based time-series database for analytics on Railway.
- [Garage S3 Storage](https://railway.com/deploy/garage-s3-storage) — Ultra-light S3 server: fast, open-source, plug-and-play.

Open this page in a browser: https://railway.com/deploy/apache-solr-or-jus-1