Skip to content

Add initial offline build instructions#206

Merged
jschwe merged 8 commits intomainfrom
offline-builds
Feb 28, 2026
Merged

Add initial offline build instructions#206
jschwe merged 8 commits intomainfrom
offline-builds

Conversation

@jschwe
Copy link
Copy Markdown
Member

@jschwe jschwe commented Feb 23, 2026 •
edited
Loading

Release v0.0.5 is the first release which contains the artifact (artifact uploaded manually, future releases will directly add it from CI)

Testing:

# in the servo repository create a new clean worktree based on latest main
git worktree add ../servo-vendor-testing
cd ../servo-vendor-testing
# Create a vendored tar-ball (which would be provided by a servo release)
./etc/vendor_servo.py
mkdir ../offline-servo
cd ../offline-servo
# Extracts the tarball into the current directory
tar -xf ../servo-vendor-testing/servo.tar.gz
uv sync
# Now disconnect the internet and build (assuming bootstrap was run before on the machine)
./mach build

@jschwe
Add initial offline build instructions
6082838 
Signed-off-by: Jonathan Schwender <schwenderjonathan@gmail.com>
jdm
jdm approved these changes Feb 24, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@jdm jdm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is nice! Just some copyediting suggestions.

Comment thread src/building/offline-builds.md Outdated
Comment thread src/building/offline-builds.md Outdated
Comment thread src/building/offline-builds.md Outdated
Comment thread src/building/offline-builds.md Outdated
Comment thread src/building/offline-builds.md Outdated
Comment thread src/building/offline-builds.md Outdated
Comment thread src/building/offline-builds.md Outdated
Comment thread src/building/offline-builds.md Outdated
Comment thread src/building/offline-builds.md Outdated
@jschwe @jdm
Apply suggestions from code review
e19214d 
Co-authored-by: Josh Matthews <josh@joshmatthews.net>
Signed-off-by: Jonathan Schwender <55576758+jschwe@users.noreply.github.com>
mrobinson
mrobinson requested changes Feb 24, 2026
View reviewed changes
Comment thread src/SUMMARY.md Outdated
Comment thread src/building/offline-builds.md Outdated
jschwe and others added 2 commits February 24, 2026 19:21
@jschwe @mrobinson
Update src/building/offline-builds.md
5022773 
Co-authored-by: Martin Robinson <mrobinson@igalia.com>
Signed-off-by: Jonathan Schwender <55576758+jschwe@users.noreply.github.com>
@jschwe @mrobinson
Update src/SUMMARY.md
44fb42e 
Co-authored-by: Martin Robinson <mrobinson@igalia.com>
Signed-off-by: Jonathan Schwender <55576758+jschwe@users.noreply.github.com>
@jschwe jschwe mentioned this pull request Feb 25, 2026
Merged
mrobinson
mrobinson approved these changes Feb 25, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@mrobinson mrobinson left a comment •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, but one general note before landing. Each sentence should be a single line according to the book style guide (see https://book.servo.org/contributing/style-guide.html#servo-book). Please do that before landing. Thanks!

Minor nits below.

Comment thread src/building/offline-builds.md Outdated
Comment thread src/building/offline-builds.md Outdated
Comment thread src/building/offline-builds.md Outdated
github-merge-queue Bot pushed a commit to servo/servo that referenced this pull request Feb 26, 2026
@jschwe
release: Upload vendored source archive (#42852)
8fcdde0 
Add a job to the release workflow which uploads a source code archive
including our vendored rust dependencies. This allows offline builds
after downloading the archive and will also be documented in the book
(see servo/book#206).

Testing: Manually tested by triggering a release on the nightly repo:
https://github.com/servo/servo/actions/runs/22405488357/job/64863992613

---------

Signed-off-by: Jonathan Schwender <schwenderjonathan@gmail.com>
github-merge-queue Bot pushed a commit to servo/servo that referenced this pull request Feb 26, 2026
@jschwe
release: Upload vendored source archive (#42852)
1668799 
Add a job to the release workflow which uploads a source code archive
including our vendored rust dependencies. This allows offline builds
after downloading the archive and will also be documented in the book
(see servo/book#206).

Testing: Manually tested by triggering a release on the nightly repo:
https://github.com/servo/servo/actions/runs/22405488357/job/64863992613

---------

Signed-off-by: Jonathan Schwender <schwenderjonathan@gmail.com>
github-merge-queue Bot pushed a commit to servo/servo that referenced this pull request Feb 26, 2026
@jschwe
release: Upload vendored source archive (#42852)
ca3ff70 
Add a job to the release workflow which uploads a source code archive
including our vendored rust dependencies. This allows offline builds
after downloading the archive and will also be documented in the book
(see servo/book#206).

Testing: Manually tested by triggering a release on the nightly repo:
https://github.com/servo/servo/actions/runs/22405488357/job/64863992613

---------

Signed-off-by: Jonathan Schwender <schwenderjonathan@gmail.com>
jschwe and others added 3 commits February 26, 2026 10:35
@jschwe @mrobinson
Apply suggestions from code review
7f5178d 
Co-authored-by: Martin Robinson <mrobinson@igalia.com>
Signed-off-by: Jonathan Schwender <55576758+jschwe@users.noreply.github.com>
@jschwe
lines
d5cdf86 
Signed-off-by: Jonathan Schwender <schwenderjonathan@gmail.com>
@jschwe
update filename
e6611cd 
Signed-off-by: Jonathan Schwender <schwenderjonathan@gmail.com>
jschwe
jschwe commented Feb 26, 2026
View reviewed changes
Comment thread src/building/offline-builds.md Outdated
@@ -0,0 +1,46 @@
# Building Offline

Servo releases provide a `servo-<release-tag>-src-vendor.tar.gz` artifact which contains Servo's source code and all Rust dependencies vendored.
Copy link
Copy Markdown
Member Author

@jschwe jschwe Feb 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I updated the asset name to the one currently created by the release workflow. We can still change it. I'm not super happy with the src-vendor suffix, but I think we do need something to indicate that it contains both the sources and vendored sources. Open for suggestions. CC @mrobinson @jdm

Copy link
Copy Markdown
Member

@jdm jdm Feb 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think src-vendored sounds clear.

jschwe added a commit to servo/servo that referenced this pull request Feb 28, 2026
@jschwe
Rename vendored artifact name in release workflow
40f1047 
As suggested in servo/book#206 (comment)

Signed-off-by: Jonathan Schwender <55576758+jschwe@users.noreply.github.com>
@jschwe jschwe mentioned this pull request Feb 28, 2026
Merged
jschwe
jschwe commented Feb 28, 2026
View reviewed changes
Comment thread src/building/offline-builds.md Outdated
github-merge-queue Bot pushed a commit to servo/servo that referenced this pull request Feb 28, 2026
@jschwe
Rename vendored artifact name in release workflow (#42920)
5c1065d 
As suggested in
servo/book#206 (comment)

Testing: Not tested, just used grep.

Signed-off-by: Jonathan Schwender <55576758+jschwe@users.noreply.github.com>
@jschwe
Update vendored artifact name according to suggestion
bc4ba0a 
Signed-off-by: Jonathan Schwender <55576758+jschwe@users.noreply.github.com>
@jschwe jschwe added this pull request to the merge queue Feb 28, 2026
Merged via the queue into main with commit f05cb05 Feb 28, 2026
shubhamg13 pushed a commit to shubhamg13/servo that referenced this pull request Mar 2, 2026
@jschwe @shubhamg13
release: Upload vendored source archive (servo#42852)
98b4679 
Add a job to the release workflow which uploads a source code archive
including our vendored rust dependencies. This allows offline builds
after downloading the archive and will also be documented in the book
(see servo/book#206).

Testing: Manually tested by triggering a release on the nightly repo:
https://github.com/servo/servo/actions/runs/22405488357/job/64863992613

---------

Signed-off-by: Jonathan Schwender <schwenderjonathan@gmail.com>
simonwuelker pushed a commit to simonwuelker/servo that referenced this pull request Mar 3, 2026
@jschwe @simonwuelker
Rename vendored artifact name in release workflow (servo#42920)
ca7c89c 
As suggested in
servo/book#206 (comment)

Testing: Not tested, just used grep.

Signed-off-by: Jonathan Schwender <55576758+jschwe@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@jdm jdm jdm approved these changes

@mrobinson mrobinson mrobinson approved these changes

@delan delan Awaiting requested review from delan delan is a code owner

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@jschwe @mrobinson @jdm