diff --git a/apps/app-frontend/src/App.vue b/apps/app-frontend/src/App.vue
index 1f39661978..017332df67 100644
--- a/apps/app-frontend/src/App.vue
+++ b/apps/app-frontend/src/App.vue
@@ -94,7 +94,12 @@ import { debugAnalytics, initAnalytics, trackEvent } from '@/helpers/analytics'
 import { check_reachable } from '@/helpers/auth.js'
 import { get_user, get_version } from '@/helpers/cache.js'
 import { command_listener, notification_listener, warning_listener } from '@/helpers/events.js'
-import { install_create_modpack_instance, install_get_modpack_preview } from '@/helpers/install'
+import {
+	install_create_modpack_instance,
+	install_get_shared_instance_preview,
+	install_get_modpack_preview,
+	install_shared_instance,
+} from '@/helpers/install'
 import { list, run } from '@/helpers/instance'
 import { cancelLogin, get as getCreds, login, logout } from '@/helpers/mr_auth.ts'
 import { mergeUrlQuery, parseModrinthLink } from '@/helpers/project-links.ts'
@@ -251,6 +256,7 @@ const {
 const news = ref([])
 const availableSurvey = ref(false)
 const displayedServerInviteNotifications = new Set()
+const displayedSharedInstanceInviteNotifications = new Set()
 
 const offline = ref(!navigator.onLine)
 window.addEventListener('offline', () => {
@@ -820,31 +826,141 @@ function openServerInviteInviterProfile(inviterName) {
 	openUrl(`${config.siteUrl}/user/${encodeURIComponent(inviterName)}`)
 }
 
+function getSharedInstanceInvite(notification) {
+	const sharedInstanceId = notification.body?.shared_instance_id
+	if (typeof sharedInstanceId !== 'string') {
+		throw new Error('Missing shared instance ID for invite notification.')
+	}
+
+	const invitedById = notification.body?.invited_by
+	const invitedByUsername =
+		typeof notification.body?.invited_by_username === 'string'
+			? notification.body.invited_by_username
+			: typeof notification.body?.inviter_username === 'string'
+				? notification.body.inviter_username
+				: null
+	const sharedInstanceName =
+		typeof notification.body.shared_instance_name === 'string'
+			? notification.body.shared_instance_name
+			: 'Shared instance'
+
+	return {
+		sharedInstanceId,
+		sharedInstanceName,
+		invitedById: typeof invitedById === 'string' ? invitedById : null,
+		invitedByUsername,
+	}
+}
+
+async function acceptSharedInstanceInviteNotification(notification) {
+	try {
+		const sharedInstanceInvite = getSharedInstanceInvite(notification)
+		const invitedBy = sharedInstanceInvite.invitedById
+			? await get_user(sharedInstanceInvite.invitedById, 'bypass').catch(() => null)
+			: null
+		const invitedByUsername = sharedInstanceInvite.invitedByUsername ?? invitedBy?.username ?? null
+		const preview = await install_get_shared_instance_preview(
+			sharedInstanceInvite.sharedInstanceId,
+			sharedInstanceInvite.sharedInstanceName,
+		)
+		const showInstallModal = installToPlayModal.value?.showSharedInstance
+
+		if (!showInstallModal) {
+			throw new Error('Install to play modal is not available.')
+		}
+
+		showInstallModal(
+			{
+				preview,
+				invitedByUsername,
+			},
+			async () => {
+				try {
+					await install_shared_instance(
+						sharedInstanceInvite.sharedInstanceId,
+						sharedInstanceInvite.sharedInstanceName,
+					)
+					await markLiveNotificationRead(notification)
+					queryClient.invalidateQueries({ queryKey: ['instances'] })
+				} catch (error) {
+					handleError(error)
+					throw error
+				}
+			},
+		)
+	} catch (error) {
+		handleError(error)
+	}
+}
+
+async function declineSharedInstanceInviteNotification(notification) {
+	try {
+		getSharedInstanceInvite(notification)
+		await markLiveNotificationRead(notification)
+	} catch (error) {
+		handleError(error)
+	}
+}
+
 async function handleLiveNotification(notification) {
-	if (notification?.body?.type !== 'server_invite' || notification.read) return
-	if (displayedServerInviteNotifications.has(notification.id)) return
-
-	displayedServerInviteNotifications.add(notification.id)
-
-	const serverName =
-		typeof notification.body.server_name === 'string' ? notification.body.server_name : 'a server'
-	const inviterId = notification.body.invited_by
-	const invitedBy =
-		typeof inviterId === 'string' ? await get_user(inviterId, 'bypass').catch(() => null) : null
-
-	addPopupNotification({
-		title: serverName,
-		autoCloseMs: null,
-		toast: {
-			type: 'server-invite',
-			actorName: invitedBy?.username ?? null,
-			actorAvatarUrl: invitedBy?.avatar_url ?? null,
-			entityName: serverName,
-			onAccept: () => acceptServerInviteNotification(notification),
-			onDecline: () => declineServerInviteNotification(notification),
-			onOpenActor: () => openServerInviteInviterProfile(invitedBy?.username ?? null),
-		},
-	})
+	if (!notification?.body || notification.read) return
+
+	if (notification.body.type === 'server_invite') {
+		if (displayedServerInviteNotifications.has(notification.id)) return
+
+		displayedServerInviteNotifications.add(notification.id)
+
+		const serverName =
+			typeof notification.body.server_name === 'string' ? notification.body.server_name : 'a server'
+		const inviterId = notification.body.invited_by
+		const invitedBy =
+			typeof inviterId === 'string' ? await get_user(inviterId, 'bypass').catch(() => null) : null
+
+		addPopupNotification({
+			title: serverName,
+			autoCloseMs: null,
+			toast: {
+				type: 'server-invite',
+				actorName: invitedBy?.username ?? null,
+				actorAvatarUrl: invitedBy?.avatar_url ?? null,
+				entityName: serverName,
+				onAccept: () => acceptServerInviteNotification(notification),
+				onDecline: () => declineServerInviteNotification(notification),
+				onOpenActor: () => openServerInviteInviterProfile(invitedBy?.username ?? null),
+			},
+		})
+	}
+
+	if (notification.body.type === 'shared_instance_invite') {
+		if (displayedSharedInstanceInviteNotifications.has(notification.id)) return
+
+		let sharedInstanceInvite
+		try {
+			sharedInstanceInvite = getSharedInstanceInvite(notification)
+		} catch (error) {
+			handleError(error)
+			return
+		}
+		displayedSharedInstanceInviteNotifications.add(notification.id)
+		const invitedBy = sharedInstanceInvite.invitedById
+			? await get_user(sharedInstanceInvite.invitedById, 'bypass').catch(() => null)
+			: null
+		const invitedByUsername = sharedInstanceInvite.invitedByUsername ?? invitedBy?.username ?? null
+
+		addPopupNotification({
+			title: sharedInstanceInvite.sharedInstanceName,
+			autoCloseMs: null,
+			toast: {
+				type: 'instance-invite',
+				actorName: invitedByUsername,
+				actorAvatarUrl: invitedBy?.avatar_url ?? null,
+				entityName: sharedInstanceInvite.sharedInstanceName,
+				onAccept: () => acceptSharedInstanceInviteNotification(notification),
+				onDecline: () => declineSharedInstanceInviteNotification(notification),
+				onOpenActor: () => openServerInviteInviterProfile(invitedByUsername),
+			},
+		})
+	}
 }
 
 async function handleCommand(e) {
diff --git a/apps/app-frontend/src/components/ui/friends/FriendsList.vue b/apps/app-frontend/src/components/ui/friends/FriendsList.vue
index c622c078e4..a7a76c4f6e 100644
--- a/apps/app-frontend/src/components/ui/friends/FriendsList.vue
+++ b/apps/app-frontend/src/components/ui/friends/FriendsList.vue
@@ -10,17 +10,22 @@ import {
 	useRelativeTime,
 	useVIntl,
 } from '@modrinth/ui'
-import { computed, onUnmounted, ref, watch } from 'vue'
+import { useMutation, useQuery, useQueryClient } from '@tanstack/vue-query'
+import { computed, onUnmounted, ref } from 'vue'
 
 import FriendsSection from '@/components/ui/friends/FriendsSection.vue'
 import ModalWrapper from '@/components/ui/modal/ModalWrapper.vue'
 import { friend_listener } from '@/helpers/events'
 import {
+	acceptCachedFriend,
 	add_friend,
-	friends,
+	createPendingFriend,
+	friendsQueryKey,
 	type FriendWithUserData,
+	getFriendsWithUserData,
 	remove_friend,
-	transformFriends,
+	removeCachedFriend,
+	upsertCachedFriend,
 } from '@/helpers/friends.ts'
 import type { ModrinthCredentials } from '@/helpers/mr_auth'
 
@@ -28,6 +33,7 @@ const { formatMessage } = useVIntl()
 
 const { handleError } = injectNotificationManager()
 const formatRelativeTime = useRelativeTime()
+const queryClient = useQueryClient()
 
 const props = defineProps<{
 	credentials: ModrinthCredentials | null
@@ -35,36 +41,22 @@ const props = defineProps<{
 }>()
 
 const userCredentials = computed(() => props.credentials)
+const friendsKey = computed(() => friendsQueryKey(userCredentials.value?.user_id))
 
 const search = ref('')
 const friendInvitesModal = ref()
 
 const username = ref('')
 const addFriendModal = ref()
-async function addFriendFromModal() {
-	addFriendModal.value.hide()
-	await add_friend(username.value).catch(handleError)
-	username.value = ''
-	await loadFriends()
-}
-
-async function addFriend(friend: FriendWithUserData) {
-	const id = friend.id === userCredentials.value?.user_id ? friend.friend_id : friend.id
-	if (id) {
-		await add_friend(id).catch(handleError)
-		await loadFriends()
-	}
-}
 
-async function removeFriend(friend: FriendWithUserData) {
-	const id = friend.id === userCredentials.value?.user_id ? friend.friend_id : friend.id
-	if (id) {
-		await remove_friend(id).catch(handleError)
-		await loadFriends()
-	}
-}
+const friendsQuery = useQuery({
+	queryKey: friendsKey,
+	queryFn: () => getFriendsWithUserData(userCredentials.value),
+	enabled: () => !!userCredentials.value,
+	staleTime: 30_000,
+})
 
-const userFriends = ref<FriendWithUserData[]>([])
+const userFriends = computed(() => friendsQuery.data.value ?? [])
 const sortedFriends = computed<FriendWithUserData[]>(() =>
 	userFriends.value.slice().sort((a, b) => {
 		if (a.last_updated === null && b.last_updated === null) {
@@ -108,39 +100,144 @@ const incomingRequests = computed(() =>
 		.sort((a, b) => b.created.diff(a.created)),
 )
 
-const loading = ref(true)
-async function loadFriends(timeout = false) {
-	loading.value = timeout
+type FriendsMutationContext = {
+	queryKey: ReturnType<typeof friendsQueryKey>
+	previousFriends?: FriendWithUserData[]
+}
 
-	try {
-		const friendsList = await friends()
-		userFriends.value = await transformFriends(friendsList, userCredentials.value)
-		loading.value = false
-	} catch (e) {
-		console.error('Error loading friends', e)
-		if (timeout) {
-			setTimeout(() => loadFriends(), 15 * 1000)
-		}
+type AddFriendMutationVariables = {
+	userId: string
+	user: {
+		id: string
+		username: string
+		avatarUrl?: string | null
 	}
+	acceptExisting?: boolean
 }
 
-watch(
-	userCredentials,
-	() => {
-		if (userCredentials.value === undefined) {
-			userFriends.value = []
-			loading.value = false
-		} else if (userCredentials.value === null) {
-			userFriends.value = []
-			loading.value = false
-		} else {
-			loadFriends(true)
-		}
+type RemoveFriendMutationVariables = {
+	userId: string
+	user: FriendWithUserData
+}
+
+const loading = computed(() => !!userCredentials.value && friendsQuery.isLoading.value)
+
+const addFriendMutation = useMutation({
+	mutationFn: ({ userId }: AddFriendMutationVariables) => add_friend(userId),
+	onMutate: async ({ user, acceptExisting }): Promise<FriendsMutationContext> => {
+		const queryKey = friendsKey.value
+		await queryClient.cancelQueries({ queryKey })
+		const previousFriends = queryClient.getQueryData<FriendWithUserData[]>(queryKey)
+
+		queryClient.setQueryData<FriendWithUserData[]>(queryKey, (friends = []) =>
+			acceptExisting
+				? acceptCachedFriend(friends, user.id, user.username, userCredentials.value?.user_id)
+				: upsertCachedFriend(
+						friends,
+						createPendingFriend(user, userCredentials.value?.user_id),
+						userCredentials.value?.user_id,
+					),
+		)
+
+		return { queryKey, previousFriends }
 	},
-	{ immediate: true },
-)
+	onError: (error, _variables, context) => {
+		restoreFriendsQuery(context)
+		handleError(toError(error))
+	},
+	onSettled: (_data, _error, _variables, context) => {
+		void queryClient.invalidateQueries({ queryKey: context?.queryKey ?? friendsKey.value })
+	},
+})
+
+const removeFriendMutation = useMutation({
+	mutationFn: ({ userId }: RemoveFriendMutationVariables) => remove_friend(userId),
+	onMutate: async ({ user, userId }): Promise<FriendsMutationContext> => {
+		const queryKey = friendsKey.value
+		await queryClient.cancelQueries({ queryKey })
+		const previousFriends = queryClient.getQueryData<FriendWithUserData[]>(queryKey)
+
+		queryClient.setQueryData<FriendWithUserData[]>(queryKey, (friends = []) =>
+			removeCachedFriend(friends, userId, user.username, userCredentials.value?.user_id),
+		)
+
+		return { queryKey, previousFriends }
+	},
+	onError: (error, _variables, context) => {
+		restoreFriendsQuery(context)
+		handleError(toError(error))
+	},
+	onSettled: (_data, _error, _variables, context) => {
+		void queryClient.invalidateQueries({ queryKey: context?.queryKey ?? friendsKey.value })
+	},
+})
+
+function restoreFriendsQuery(context?: FriendsMutationContext) {
+	if (!context) return
+
+	if (context.previousFriends === undefined) {
+		queryClient.removeQueries({ queryKey: context.queryKey, exact: true })
+		return
+	}
+
+	queryClient.setQueryData(context.queryKey, context.previousFriends)
+}
+
+function toError(error: unknown) {
+	if (error instanceof Error) return error
+	if (typeof error === 'string') return new Error(error)
+	if (error && typeof error === 'object') {
+		const record = error as Record<string, unknown>
+		const message = record.message ?? record.error
+		if (typeof message === 'string') return new Error(message)
+		return new Error(JSON.stringify(error))
+	}
+	return new Error(String(error))
+}
+
+function addFriendFromModal() {
+	const target = username.value.trim()
+	if (!target) return
+
+	addFriendModal.value.hide()
+	addFriendMutation.mutate({
+		userId: target,
+		user: {
+			id: target,
+			username: target,
+		},
+	})
+	username.value = ''
+}
+
+function addFriend(friend: FriendWithUserData) {
+	const id = friend.id === userCredentials.value?.user_id ? friend.friend_id : friend.id
+	if (id) {
+		addFriendMutation.mutate({
+			userId: id,
+			user: {
+				id,
+				username: friend.username,
+				avatarUrl: friend.avatar,
+			},
+			acceptExisting: true,
+		})
+	}
+}
 
-const unlisten = await friend_listener(() => loadFriends())
+function removeFriend(friend: FriendWithUserData) {
+	const id = friend.id === userCredentials.value?.user_id ? friend.friend_id : friend.id
+	if (id) {
+		removeFriendMutation.mutate({
+			userId: id,
+			user: friend,
+		})
+	}
+}
+
+const unlisten = await friend_listener(() => {
+	void queryClient.invalidateQueries({ queryKey: friendsKey.value })
+})
 onUnmounted(() => {
 	unlisten()
 })
diff --git a/apps/app-frontend/src/components/ui/instance/InstanceAdmonitions.vue b/apps/app-frontend/src/components/ui/instance/InstanceAdmonitions.vue
new file mode 100644
index 0000000000..1df46f6281
--- /dev/null
+++ b/apps/app-frontend/src/components/ui/instance/InstanceAdmonitions.vue
@@ -0,0 +1,111 @@
+<template>
+	<StackedAdmonitions :items="stackItems" class="w-full">
+		<template #item="{ item }">
+			<Admonition
+				v-if="item.kind === 'shared-instance-stale'"
+				type="warning"
+				inline-actions
+				:header="formatMessage(messages.sharedInstanceChangesHeader)"
+			>
+				{{ formatMessage(messages.sharedInstanceChangesBody) }}
+				<template #actions>
+					<ButtonStyled color="orange">
+						<button class="!h-10" :disabled="isPublishing" @click="publishSharedInstanceChanges">
+							<UploadIcon aria-hidden="true" />
+							{{
+								isPublishing
+									? formatMessage(messages.sharedInstancePublishingButton)
+									: formatMessage(messages.sharedInstancePublishButton)
+							}}
+						</button>
+					</ButtonStyled>
+				</template>
+			</Admonition>
+		</template>
+	</StackedAdmonitions>
+</template>
+
+<script setup lang="ts">
+import { UploadIcon } from '@modrinth/assets'
+import {
+	Admonition,
+	ButtonStyled,
+	defineMessages,
+	injectNotificationManager,
+	type StackedAdmonitionItem,
+	StackedAdmonitions,
+	useVIntl,
+} from '@modrinth/ui'
+import { computed, ref } from 'vue'
+
+import { publish_shared_instance } from '@/helpers/instance'
+import type { GameInstance } from '@/helpers/types'
+
+type InstanceAdmonitionItem = StackedAdmonitionItem & {
+	kind: 'shared-instance-stale'
+}
+
+const props = defineProps<{
+	instance: GameInstance
+}>()
+
+const emit = defineEmits<{
+	published: []
+}>()
+
+const messages = defineMessages({
+	sharedInstanceChangesHeader: {
+		id: 'app.instance.admonitions.shared-instance.changes-header',
+		defaultMessage: "Your changes haven't been shared yet",
+	},
+	sharedInstanceChangesBody: {
+		id: 'app.instance.admonitions.shared-instance.changes-body',
+		defaultMessage: "Your local instance is ahead of the users you've shared it with.",
+	},
+	sharedInstancePublishButton: {
+		id: 'app.instance.admonitions.shared-instance.publish-button',
+		defaultMessage: 'Push update',
+	},
+	sharedInstancePublishingButton: {
+		id: 'app.instance.admonitions.shared-instance.publishing-button',
+		defaultMessage: 'Pushing...',
+	},
+})
+
+const { formatMessage } = useVIntl()
+const { handleError } = injectNotificationManager()
+const isPublishing = ref(false)
+
+const showSharedInstancePublishAdmonition = computed(
+	() =>
+		props.instance.shared_instance?.role === 'owner' &&
+		props.instance.shared_instance.status === 'stale',
+)
+
+const stackItems = computed<InstanceAdmonitionItem[]>(() => {
+	if (!showSharedInstancePublishAdmonition.value) return []
+
+	return [
+		{
+			id: 'shared-instance-stale',
+			type: 'warning',
+			dismissible: false,
+			kind: 'shared-instance-stale',
+		},
+	]
+})
+
+async function publishSharedInstanceChanges() {
+	if (isPublishing.value) return
+
+	isPublishing.value = true
+	try {
+		await publish_shared_instance(props.instance.id)
+		emit('published')
+	} catch (err) {
+		handleError(err as Error)
+	} finally {
+		isPublishing.value = false
+	}
+}
+</script>
diff --git a/apps/app-frontend/src/components/ui/modal/InstallToPlayModal.vue b/apps/app-frontend/src/components/ui/modal/InstallToPlayModal.vue
index b002aa6ab8..734276faea 100644
--- a/apps/app-frontend/src/components/ui/modal/InstallToPlayModal.vue
+++ b/apps/app-frontend/src/components/ui/modal/InstallToPlayModal.vue
@@ -1,6 +1,9 @@
 <template>
 	<NewModal ref="modal" :header="formatMessage(messages.installToPlay)" :closable="true">
-		<div v-if="requiredContentProject" class="flex flex-col gap-6 max-w-[500px]">
+		<div
+			v-if="mode === 'server-project' && requiredContentProject"
+			class="flex flex-col gap-6 max-w-[500px]"
+		>
 			<Admonition type="info" :header="formatMessage(messages.contentRequired)">
 				{{ formatMessage(messages.serverRequiresMods) }}
 			</Admonition>
@@ -44,6 +47,63 @@
 				</div>
 			</div>
 		</div>
+		<div
+			v-else-if="mode === 'shared-instance' && sharedInstance"
+			class="flex flex-col gap-6 max-w-[500px]"
+		>
+			<Admonition type="warning" :header="formatMessage(messages.trustWarningHeader)">
+				{{ formatMessage(messages.trustWarningDescription) }}
+			</Admonition>
+
+			<div class="flex flex-col gap-1">
+				<div class="flex justify-between items-center">
+					<span class="font-semibold text-contrast">{{
+						formatMessage(messages.sharedInstance)
+					}}</span>
+
+					<ButtonStyled type="transparent">
+						<button @click="openViewContents">
+							<EyeIcon />
+							{{ formatMessage(messages.viewContents) }}
+						</button>
+					</ButtonStyled>
+				</div>
+
+				<div class="flex items-center gap-3 rounded-xl bg-surface-2 p-3">
+					<Avatar
+						:src="sharedInstance.preview.iconUrl"
+						:alt="sharedInstance.preview.name"
+						size="48px"
+					/>
+					<div class="flex flex-col gap-0.5">
+						<span class="font-semibold text-contrast">{{ sharedInstance.preview.name }}</span>
+						<span class="text-sm text-secondary">
+							{{ sharedInstanceLoaderDisplay }} {{ sharedInstance.preview.gameVersion }}
+							<template v-if="sharedInstance.preview.modCount">
+								·
+								{{
+									formatMessage(messages.modCount, {
+										count: sharedInstance.preview.modCount,
+									})
+								}}
+							</template>
+						</span>
+					</div>
+				</div>
+			</div>
+
+			<div
+				v-if="sharedInstance.preview.externalFileCount"
+				class="flex items-center gap-2 text-orange"
+			>
+				<IssuesIcon class="h-5 w-5 flex-none" />
+				<span>{{
+					formatMessage(messages.externalFileWarning, {
+						count: sharedInstance.preview.externalFileCount,
+					})
+				}}</span>
+			</div>
+		</div>
 
 		<template #actions>
 			<div class="flex justify-end gap-2">
@@ -65,14 +125,14 @@
 
 	<ModpackContentModal
 		ref="modpackContentModal"
-		:modpack-name="project?.name ?? ''"
-		:modpack-icon-url="project?.icon_url ?? undefined"
+		:modpack-name="contentModalName"
+		:modpack-icon-url="contentModalIconUrl"
 	/>
 </template>
 
 <script setup lang="ts">
 import type { Labrinth } from '@modrinth/api-client'
-import { DownloadIcon, EyeIcon, XIcon } from '@modrinth/assets'
+import { DownloadIcon, EyeIcon, IssuesIcon, XIcon } from '@modrinth/assets'
 import type { ContentItem } from '@modrinth/ui'
 import {
 	Admonition,
@@ -89,14 +149,21 @@ import { computed, ref } from 'vue'
 
 import { hide_ads_window, show_ads_window } from '@/helpers/ads'
 import { get_project, get_project_many, get_version, get_version_many } from '@/helpers/cache.js'
+import type { SharedInstanceInstallPreview } from '@/helpers/install'
 import { injectServerInstall } from '@/providers/server-install'
 
 const modal = ref<InstanceType<typeof NewModal>>()
+const mode = ref<'server-project' | 'shared-instance'>('server-project')
 const modpackVersionId = ref<string | null>(null)
 const modpackVersion = ref<Labrinth.Versions.v2.Version | null>(null)
 const project = ref<Labrinth.Projects.v3.Project | null>(null)
 const requiredContentProject = ref<Labrinth.Projects.v2.Project | null>(null)
 const onInstallComplete = ref<() => void>(() => {})
+const sharedInstance = ref<{
+	preview: SharedInstanceInstallPreview
+	invitedByUsername?: string | null
+} | null>(null)
+const onSharedInstanceInstall = ref<() => void | Promise<void>>(() => {})
 const { formatMessage } = useVIntl()
 const { installServerProject, startInstallingServer, stopInstallingServer } = injectServerInstall()
 
@@ -111,6 +178,21 @@ const loaderDisplay = computed(() => {
 })
 
 const modCount = computed(() => modpackVersion.value?.dependencies?.length)
+const sharedInstanceLoaderDisplay = computed(() => {
+	const loader = sharedInstance.value?.preview.loader
+	if (!loader) return ''
+	return formatLoader(formatMessage, loader)
+})
+const contentModalName = computed(() =>
+	mode.value === 'shared-instance'
+		? (sharedInstance.value?.preview.name ?? '')
+		: (project.value?.name ?? ''),
+)
+const contentModalIconUrl = computed(() =>
+	mode.value === 'shared-instance'
+		? (sharedInstance.value?.preview.iconUrl ?? undefined)
+		: (project.value?.icon_url ?? undefined),
+)
 
 async function fetchData(versionId: string) {
 	// cache is making version null for some reason so bypassing for now
@@ -123,6 +205,15 @@ async function fetchData(versionId: string) {
 
 async function handleAccept() {
 	hide()
+	if (mode.value === 'shared-instance') {
+		try {
+			await onSharedInstanceInstall.value()
+		} catch (error) {
+			console.error('Failed to install shared instance from InstallToPlayModal:', error)
+		}
+		return
+	}
+
 	const serverProjectId = project.value?.id
 	startInstallingServer(serverProjectId)
 	try {
@@ -142,6 +233,11 @@ function handleDecline() {
 const modpackContentModal = ref<InstanceType<typeof ModpackContentModal>>()
 
 async function openViewContents() {
+	if (mode.value === 'shared-instance') {
+		await openSharedInstanceContents()
+		return
+	}
+
 	modpackContentModal.value?.showLoading()
 	try {
 		// Ensure version data is available — the useQuery may not have resolved yet
@@ -207,17 +303,76 @@ async function openViewContents() {
 	}
 }
 
+async function openSharedInstanceContents() {
+	const preview = sharedInstance.value?.preview
+	if (!preview) return
+
+	modpackContentModal.value?.showLoading()
+	try {
+		const versions: Labrinth.Versions.v2.Version[] =
+			preview.contentVersionIds.length > 0
+				? await get_version_many(preview.contentVersionIds, 'must_revalidate')
+				: []
+		const projectIds = versions
+			.map((version) => version.project_id)
+			.filter((id): id is string => !!id)
+		const projects: Labrinth.Projects.v2.Project[] =
+			projectIds.length > 0 ? await get_project_many(projectIds, 'must_revalidate') : []
+		const projectMap = new Map(projects.map((project) => [project.id, project]))
+		const contentItems: ContentItem[] = [
+			...preview.externalFiles.map((file): ContentItem => {
+				return {
+					file_name: file.fileName,
+					project_type: file.fileType,
+					has_update: false,
+					update_version_id: null,
+				}
+			}),
+			...versions.map((version): ContentItem => {
+				const project = projectMap.get(version.project_id)
+
+				return {
+					file_name: version.files?.[0]?.filename ?? project?.title ?? 'Unknown',
+					project_type: project?.project_type ?? 'mod',
+					has_update: false,
+					update_version_id: null,
+					project: {
+						id: project?.id ?? version.project_id,
+						slug: project?.slug ?? version.project_id,
+						title: project?.title ?? version.name,
+						icon_url: project?.icon_url ?? undefined,
+					},
+					version: {
+						id: version.id,
+						file_name: version.files?.[0]?.filename,
+						version_number: version.version_number ?? undefined,
+						date_published: version.date_published ?? undefined,
+					},
+				}
+			}),
+		]
+
+		modpackContentModal.value?.show(contentItems)
+	} catch (err) {
+		console.error('Failed to load shared instance contents:', err)
+		modpackContentModal.value?.show([])
+	}
+}
+
 async function show(
 	projectVal: Labrinth.Projects.v3.Project,
 	modpackVersionIdVal: string | null = null,
 	callback: () => void = () => {},
 	e?: MouseEvent,
 ) {
+	mode.value = 'server-project'
 	project.value = projectVal
+	sharedInstance.value = null
 	modpackVersionId.value = modpackVersionIdVal
 	modpackVersion.value = null
 	requiredContentProject.value = null
 	onInstallComplete.value = callback
+	onSharedInstanceInstall.value = () => {}
 
 	if (modpackVersionIdVal) await fetchData(modpackVersionIdVal)
 
@@ -225,6 +380,27 @@ async function show(
 	modal.value?.show(e)
 }
 
+function showSharedInstance(
+	instance: {
+		preview: SharedInstanceInstallPreview
+		invitedByUsername?: string | null
+	},
+	install: () => void | Promise<void>,
+	e?: MouseEvent,
+) {
+	mode.value = 'shared-instance'
+	project.value = null
+	modpackVersionId.value = null
+	modpackVersion.value = null
+	requiredContentProject.value = null
+	onInstallComplete.value = () => {}
+	sharedInstance.value = instance
+	onSharedInstanceInstall.value = install
+
+	hide_ads_window()
+	modal.value?.show(e)
+}
+
 function hide() {
 	modal.value?.hide()
 	show_ads_window()
@@ -256,6 +432,20 @@ const messages = defineMessages({
 		id: 'app.modal.install-to-play.shared-instance',
 		defaultMessage: 'Shared instance',
 	},
+	trustWarningHeader: {
+		id: 'app.modal.install-to-play.trust-warning-header',
+		defaultMessage: 'Do you trust this user?',
+	},
+	trustWarningDescription: {
+		id: 'app.modal.install-to-play.trust-warning-description',
+		defaultMessage:
+			'A shared instance will install files on your computer and may include content not from Modrinth.',
+	},
+	externalFileWarning: {
+		id: 'app.modal.install-to-play.external-file-warning',
+		defaultMessage:
+			'{count, plural, one {This instance includes # file that is not from Modrinth.} other {This instance includes # files that are not from Modrinth.}}',
+	},
 	modCount: {
 		id: 'app.modal.install-to-play.mod-count',
 		defaultMessage: '{count, plural, one {# mod} other {# mods}}',
@@ -270,5 +460,5 @@ const messages = defineMessages({
 	},
 })
 
-defineExpose({ show, hide })
+defineExpose({ show, showSharedInstance, hide })
 </script>
diff --git a/apps/app-frontend/src/components/ui/modal/UpdateToPlayModal.vue b/apps/app-frontend/src/components/ui/modal/UpdateToPlayModal.vue
index ab5c3b7acb..4af6339228 100644
--- a/apps/app-frontend/src/components/ui/modal/UpdateToPlayModal.vue
+++ b/apps/app-frontend/src/components/ui/modal/UpdateToPlayModal.vue
@@ -9,7 +9,7 @@
 		:diffs="normalizedDiffs"
 		:confirm-label="formatMessage(commonMessages.updateButton)"
 		:confirm-icon="DownloadIcon"
-		:show-report-button="true"
+		:show-report-button="showReportButton"
 		@confirm="handleUpdate"
 		@cancel="handleDecline"
 		@report="handleReport"
@@ -31,7 +31,11 @@ import dayjs from 'dayjs'
 import { computed, ref, watch } from 'vue'
 
 import { get_project_many, get_version, get_version_many } from '@/helpers/cache.js'
-import { wait_for_install_job } from '@/helpers/install'
+import {
+	install_update_shared_instance,
+	type SharedInstanceUpdatePreview,
+	wait_for_install_job,
+} from '@/helpers/install'
 import { update_managed_modrinth_version } from '@/helpers/instance'
 import type { GameInstance } from '@/helpers/types'
 import { injectServerInstall } from '@/providers/server-install'
@@ -79,20 +83,35 @@ type UpdateCompleteCallback = () => void | Promise<void>
 
 const diffModal = ref<InstanceType<typeof ContentDiffModal>>()
 const instance = ref<GameInstance | null>(null)
+const mode = ref<'server-project' | 'shared-instance'>('server-project')
 const onUpdateComplete = ref<UpdateCompleteCallback>(() => {})
 const diffs = ref<DependencyDiff[]>([])
+const sharedInstancePreview = ref<SharedInstanceUpdatePreview | null>(null)
 const modpackVersionId = ref<string | null>(null)
 const modpackVersion = ref<Version | null>(null)
 
-const normalizedDiffs = computed<ContentDiffItem[]>(() =>
-	diffs.value.map((diff) => ({
+const normalizedDiffs = computed<ContentDiffItem[]>(() => {
+	if (mode.value === 'shared-instance') {
+		return (
+			sharedInstancePreview.value?.diffs.map((diff) => ({
+				type: diff.type,
+				projectName: diff.projectName ?? undefined,
+				fileName: diff.fileName ?? undefined,
+				currentVersionName: diff.currentVersionName ?? undefined,
+				newVersionName: diff.newVersionName ?? undefined,
+			})) ?? []
+		)
+	}
+
+	return diffs.value.map((diff) => ({
 		type: diff.type,
 		projectName: diff.project?.title,
 		fileName: diff.fileName,
 		currentVersionName: diff.currentVersion?.version_number,
 		newVersionName: diff.newVersion?.version_number,
-	})),
-)
+	}))
+})
+const showReportButton = computed(() => mode.value !== 'shared-instance')
 
 async function computeDependencyDiffs(
 	currentDeps: Dependency[],
@@ -239,6 +258,19 @@ watch(
 
 async function handleUpdate() {
 	hide()
+	if (mode.value === 'shared-instance') {
+		try {
+			if (instance.value) {
+				const job = await install_update_shared_instance(instance.value.id)
+				await wait_for_install_job(job.job_id)
+				await onUpdateComplete.value()
+			}
+		} catch (error) {
+			console.error('Error updating shared instance:', error)
+		}
+		return
+	}
+
 	const serverProjectId = instance.value?.link?.project_id
 	if (serverProjectId) startInstallingServer(serverProjectId)
 	try {
@@ -270,12 +302,29 @@ function show(
 	callback: UpdateCompleteCallback = () => {},
 	e?: MouseEvent,
 ) {
+	mode.value = 'server-project'
 	instance.value = instanceVal
+	sharedInstancePreview.value = null
 	modpackVersionId.value = modpackVersionIdVal
 	onUpdateComplete.value = callback
 	diffModal.value?.show(e)
 }
 
+function showSharedInstance(
+	instanceVal: GameInstance,
+	preview: SharedInstanceUpdatePreview,
+	callback: UpdateCompleteCallback = () => {},
+	e?: MouseEvent,
+) {
+	mode.value = 'shared-instance'
+	instance.value = instanceVal
+	sharedInstancePreview.value = preview
+	modpackVersionId.value = null
+	diffs.value = []
+	onUpdateComplete.value = callback
+	diffModal.value?.show(e)
+}
+
 function hide() {
 	diffModal.value?.hide()
 }
@@ -292,7 +341,7 @@ const messages = defineMessages({
 	updateRequiredDescription: {
 		id: 'app.modal.update-to-play.update-required-description',
 		defaultMessage:
-			'An update is required to play {name}. Please update to the latest version to launch the game.',
+			'An update is required to play {name}. Please update to latest version to launch the game.',
 	},
 })
 
@@ -301,5 +350,5 @@ const hasUpdate = computed(() => {
 	return modpackVersionId.value != null && modpackVersionId.value !== instance.value.link.version_id
 })
 
-defineExpose({ show, hide, hasUpdate })
+defineExpose({ show, showSharedInstance, hide, hasUpdate })
 </script>
diff --git a/apps/app-frontend/src/helpers/friends.ts b/apps/app-frontend/src/helpers/friends.ts
index 7fd27b5a88..da037df597 100644
--- a/apps/app-frontend/src/helpers/friends.ts
+++ b/apps/app-frontend/src/helpers/friends.ts
@@ -6,6 +6,8 @@ import dayjs from 'dayjs'
 import { get_user_many } from '@/helpers/cache'
 import type { ModrinthCredentials } from '@/helpers/mr_auth'
 
+export const friendsQueryKey = (userId?: string | null) => ['friends', userId ?? null] as const
+
 export type UserStatus = {
 	user_id: string
 	instance_name: string | null
@@ -46,6 +48,111 @@ export type FriendWithUserData = {
 	online: boolean
 	avatar: string
 }
+
+export type FriendCacheUser = {
+	id: string
+	username: string
+	avatarUrl?: string | null
+}
+
+export async function getFriendsWithUserData(
+	credentials: ModrinthCredentials | null,
+): Promise<FriendWithUserData[]> {
+	if (!credentials) return []
+
+	const friendsList = await friends()
+	return await transformFriends(friendsList, credentials)
+}
+
+export function createPendingFriend(
+	user: FriendCacheUser,
+	currentUserId?: string | null,
+): FriendWithUserData {
+	return {
+		id: user.id,
+		friend_id: currentUserId ?? null,
+		status: null,
+		last_updated: null,
+		created: dayjs(),
+		username: user.username,
+		accepted: false,
+		online: false,
+		avatar: user.avatarUrl ?? '',
+	}
+}
+
+export function getFriendUserId(
+	friend: Pick<FriendWithUserData, 'id' | 'friend_id'>,
+	currentUserId?: string | null,
+) {
+	return friend.id === currentUserId && friend.friend_id ? friend.friend_id : friend.id
+}
+
+export function matchesFriend(
+	friend: FriendWithUserData,
+	id: string,
+	username: string,
+	currentUserId?: string | null,
+) {
+	const friendId = getFriendUserId(friend, currentUserId)
+	return (
+		normalizeFriendKey(friendId) === normalizeFriendKey(id) ||
+		normalizeFriendKey(friend.username) === normalizeFriendKey(username)
+	)
+}
+
+export function upsertCachedFriend(
+	friends: FriendWithUserData[],
+	friend: FriendWithUserData,
+	currentUserId?: string | null,
+) {
+	const existingFriend = friends.find((cachedFriend) =>
+		matchesFriend(cachedFriend, friend.id, friend.username, currentUserId),
+	)
+
+	if (!existingFriend) return [friend, ...friends]
+
+	return friends.map((cachedFriend) =>
+		matchesFriend(cachedFriend, friend.id, friend.username, currentUserId)
+			? {
+					...cachedFriend,
+					...friend,
+					id: cachedFriend.id,
+					friend_id: cachedFriend.friend_id,
+				}
+			: cachedFriend,
+	)
+}
+
+export function acceptCachedFriend(
+	friends: FriendWithUserData[],
+	id: string,
+	username: string,
+	currentUserId?: string | null,
+) {
+	return friends.map((friend) =>
+		matchesFriend(friend, id, username, currentUserId)
+			? {
+					...friend,
+					accepted: true,
+				}
+			: friend,
+	)
+}
+
+export function removeCachedFriend(
+	friends: FriendWithUserData[],
+	id: string,
+	username: string,
+	currentUserId?: string | null,
+) {
+	return friends.filter((friend) => !matchesFriend(friend, id, username, currentUserId))
+}
+
+function normalizeFriendKey(value: string) {
+	return value.trim().toLowerCase()
+}
+
 export async function transformFriends(
 	friends: UserFriend[],
 	credentials: ModrinthCredentials | null,
diff --git a/apps/app-frontend/src/helpers/install.ts b/apps/app-frontend/src/helpers/install.ts
index 20ca0810a0..60ea89a8c8 100644
--- a/apps/app-frontend/src/helpers/install.ts
+++ b/apps/app-frontend/src/helpers/install.ts
@@ -44,6 +44,39 @@ export interface InstallPostInstallEdit {
 	link?: InstanceLink | null
 }
 
+export interface SharedInstanceInstallPreview {
+	name: string
+	iconUrl?: string | null
+	gameVersion: string
+	loader: InstanceLoader
+	modCount: number
+	externalFileCount: number
+	contentVersionIds: string[]
+	externalFiles: SharedInstanceExternalFilePreview[]
+}
+
+export interface SharedInstanceExternalFilePreview {
+	fileName: string
+	fileType: string
+}
+
+export interface SharedInstanceUpdatePreview {
+	sharedInstanceId: string
+	currentVersion?: number | null
+	latestVersion: number
+	updateAvailable: boolean
+	diffs: SharedInstanceUpdateDiff[]
+}
+
+export interface SharedInstanceUpdateDiff {
+	type: 'added' | 'removed' | 'updated'
+	projectId?: string | null
+	projectName?: string | null
+	fileName?: string | null
+	currentVersionName?: string | null
+	newVersionName?: string | null
+}
+
 export type InstallJobStatus =
 	| 'queued'
 	| 'running'
@@ -91,6 +124,8 @@ export interface InstallJobSnapshot {
 	kind:
 		| 'create_instance'
 		| 'create_modpack_instance'
+		| 'create_shared_instance'
+		| 'update_shared_instance'
 		| 'import_instance'
 		| 'duplicate_instance'
 		| 'install_existing_instance'
@@ -140,6 +175,38 @@ export async function install_create_modpack_instance(
 	})
 }
 
+export async function install_get_shared_instance_preview(sharedInstanceId: string, name: string) {
+	return await invoke<SharedInstanceInstallPreview>(
+		'plugin:install|install_get_shared_instance_preview',
+		{
+			sharedInstanceId,
+			name,
+		},
+	)
+}
+
+export async function install_get_shared_instance_update_preview(instanceId: string) {
+	return await invoke<SharedInstanceUpdatePreview | null>(
+		'plugin:install|install_get_shared_instance_update_preview',
+		{
+			instanceId,
+		},
+	)
+}
+
+export async function install_shared_instance(sharedInstanceId: string, name: string) {
+	return await invoke<InstallJobSnapshot>('plugin:install|install_shared_instance', {
+		sharedInstanceId,
+		name,
+	})
+}
+
+export async function install_update_shared_instance(instanceId: string) {
+	return await invoke<InstallJobSnapshot>('plugin:install|install_update_shared_instance', {
+		instanceId,
+	})
+}
+
 export async function install_import_instance(
 	launcherType: string,
 	basePath: string,
diff --git a/apps/app-frontend/src/helpers/instance.ts b/apps/app-frontend/src/helpers/instance.ts
index 4570973974..2997482bc7 100644
--- a/apps/app-frontend/src/helpers/instance.ts
+++ b/apps/app-frontend/src/helpers/instance.ts
@@ -14,6 +14,7 @@ import type {
 	ContentFileProjectType,
 	GameInstance,
 	InstanceLoader,
+	SharedInstanceAttachment,
 } from './types'
 
 export async function remove(instanceId: string): Promise<void> {
@@ -331,3 +332,31 @@ export async function edit(instanceId: string, editInstance: Partial<GameInstanc
 export async function edit_icon(instanceId: string, iconPath: string | null): Promise<void> {
 	return await invoke('plugin:instance|instance_edit_icon', { instanceId, iconPath })
 }
+
+export type SharedInstanceUsers = {
+	user_ids: string[]
+}
+
+export async function get_shared_instance_users(instanceId: string): Promise<SharedInstanceUsers> {
+	return await invoke('plugin:instance|instance_share_get_users', { instanceId })
+}
+
+export async function invite_shared_instance_users(
+	instanceId: string,
+	userIds: string[],
+): Promise<SharedInstanceUsers> {
+	return await invoke('plugin:instance|instance_share_invite_users', { instanceId, userIds })
+}
+
+export async function remove_shared_instance_users(
+	instanceId: string,
+	userIds: string[],
+): Promise<SharedInstanceUsers> {
+	return await invoke('plugin:instance|instance_share_remove_users', { instanceId, userIds })
+}
+
+export async function publish_shared_instance(
+	instanceId: string,
+): Promise<SharedInstanceAttachment> {
+	return await invoke('plugin:instance|instance_share_publish', { instanceId })
+}
diff --git a/apps/app-frontend/src/helpers/types.d.ts b/apps/app-frontend/src/helpers/types.d.ts
index 0bd0101461..58c12f0640 100644
--- a/apps/app-frontend/src/helpers/types.d.ts
+++ b/apps/app-frontend/src/helpers/types.d.ts
@@ -17,6 +17,7 @@ export type GameInstance = {
 	groups: string[]
 
 	link?: InstanceLink | null
+	shared_instance?: SharedInstanceAttachment | null
 	update_channel: ReleaseChannel
 
 	created: Date
@@ -86,18 +87,41 @@ export type InstanceLink = InstanceLinkIdentity &
 		  }
 		| {
 				type: 'shared_instance'
-				shared_instance_id: string
 		  }
 	)
 
+export type SharedInstanceAttachment = {
+	id: string
+	role: 'owner' | 'member'
+	status:
+		| 'unknown'
+		| 'up_to_date'
+		| 'update_available'
+		| 'applying'
+		| 'stale'
+		| 'not_ready'
+		| 'error'
+	applied_version?: number | null
+	latest_version?: number | null
+}
+
 export type Instance = GameInstance
 
 type ReleaseChannel = 'release' | 'beta' | 'alpha'
 
 export type InstanceLoader = 'vanilla' | 'forge' | 'fabric' | 'quilt' | 'neoforge'
 
+export type ContentSourceKind =
+	| 'local'
+	| 'modrinth_modpack'
+	| 'server_project'
+	| 'modrinth_hosting'
+	| 'imported_modpack'
+	| 'shared_instance'
+
 type ContentFile = {
 	enabled: boolean
+	source_kind?: ContentSourceKind | null
 	metadata?: {
 		project_id: string
 		version_id: string
diff --git a/apps/app-frontend/src/helpers/users.ts b/apps/app-frontend/src/helpers/users.ts
new file mode 100644
index 0000000000..042b0d4cbb
--- /dev/null
+++ b/apps/app-frontend/src/helpers/users.ts
@@ -0,0 +1,11 @@
+import { invoke } from '@tauri-apps/api/core'
+
+export type SearchUser = {
+	id: string
+	username: string
+	avatar_url: string | null
+}
+
+export async function search_user(query: string): Promise<SearchUser[]> {
+	return await invoke<SearchUser[]>('plugin:users|search_user', { query })
+}
diff --git a/apps/app-frontend/src/locales/en-US/index.json b/apps/app-frontend/src/locales/en-US/index.json
index e5a64ba46c..5f4186aa2b 100644
--- a/apps/app-frontend/src/locales/en-US/index.json
+++ b/apps/app-frontend/src/locales/en-US/index.json
@@ -269,6 +269,18 @@
   "app.install.phase.running_loader_processors": {
     "message": "Running loader processors"
   },
+  "app.instance.admonitions.shared-instance.changes-body": {
+    "message": "Your local instance is ahead of the users you've shared it with."
+  },
+  "app.instance.admonitions.shared-instance.changes-header": {
+    "message": "Your changes haven't been shared yet"
+  },
+  "app.instance.admonitions.shared-instance.publish-button": {
+    "message": "Push update"
+  },
+  "app.instance.admonitions.shared-instance.publishing-button": {
+    "message": "Pushing..."
+  },
   "app.instance.confirm-delete.admonition-body": {
     "message": "All data for your instance will be permanently deleted, including your worlds, configs, and all installed content."
   },
@@ -320,6 +332,27 @@
   "app.instance.mods.successfully-uploaded": {
     "message": "Successfully uploaded"
   },
+  "app.instance.share.empty.description": {
+    "message": "You can share this instance with your friends!"
+  },
+  "app.instance.share.empty.heading": {
+    "message": "No friends invited"
+  },
+  "app.instance.share.empty.invite-friends-button": {
+    "message": "Invite friends"
+  },
+  "app.instance.share.invite-modal.heading": {
+    "message": "Share {name}"
+  },
+  "app.instance.share.sign-in.button": {
+    "message": "Sign in"
+  },
+  "app.instance.share.sign-in.description": {
+    "message": "You need a Modrinth account to share instances."
+  },
+  "app.instance.share.sign-in.heading": {
+    "message": "Sign in to share"
+  },
   "app.instance.worlds.add-server": {
     "message": "Add server"
   },
diff --git a/apps/app-frontend/src/pages/instance/Index.vue b/apps/app-frontend/src/pages/instance/Index.vue
index 122edf3a84..59f834ee56 100644
--- a/apps/app-frontend/src/pages/instance/Index.vue
+++ b/apps/app-frontend/src/pages/instance/Index.vue
@@ -25,6 +25,18 @@
 				<template #title>
 					{{ instance.name }}
 				</template>
+				<template v-if="instance.shared_instance" #title-suffix>
+					<div
+						class="inline-flex h-7 items-center gap-1 rounded-full border border-solid border-blue bg-highlight-blue px-2.5 !text-base !font-normal leading-none text-blue"
+					>
+						Shared
+						<UnknownIcon
+							v-tooltip="'This instance is being shared to other users.'"
+							class="size-4 cursor-help"
+							aria-label="Shared instance information"
+						/>
+					</div>
+				</template>
 				<template #stats>
 					<div class="flex items-center flex-wrap gap-2">
 						<template v-if="!isServerInstance">
@@ -89,6 +101,23 @@
 								</router-link>
 							</div>
 						</template>
+
+						<template v-if="sharedInstanceManager">
+							<div class="w-1.5 h-1.5 rounded-full bg-surface-5"></div>
+
+							<div class="flex min-w-0 items-center gap-[5px] font-medium">
+								Managed by
+								<Avatar
+									:src="sharedInstanceManager.avatarUrl"
+									:alt="sharedInstanceManager.username"
+									:tint-by="sharedInstanceManager.tintBy"
+									size="24px"
+									circle
+									no-shadow
+								/>
+								<span class="min-w-0 truncate">{{ sharedInstanceManager.username }}</span>
+							</div>
+						</template>
 					</div>
 				</template>
 				<template #actions>
@@ -217,6 +246,7 @@
 		</div>
 		<div :class="['px-6', { 'shrink-0': isFixedRender }]">
 			<NavTabs :links="tabs" />
+			<InstanceAdmonitions class="mt-4" :instance="instance" @published="fetchInstance" />
 		</div>
 		<div :class="['p-6 pt-4', { 'min-h-0 flex-1 overflow-y-auto': isFixedRender }]">
 			<RouterView v-slot="{ Component }" :key="instance.id" :route="displayedInstanceRoute">
@@ -288,6 +318,7 @@ import {
 	SettingsIcon,
 	StopCircleIcon,
 	TerminalSquareIcon,
+	UnknownIcon,
 	UpdatedIcon,
 	UserPlusIcon,
 	XIcon,
@@ -296,6 +327,7 @@ import {
 	Avatar,
 	ButtonStyled,
 	ContentPageHeader,
+	injectAuth,
 	injectNotificationManager,
 	NavTabs,
 	OverflowMenu,
@@ -315,13 +347,18 @@ import { useRoute, useRouter } from 'vue-router'
 
 import ContextMenu from '@/components/ui/ContextMenu.vue'
 import ExportModal from '@/components/ui/ExportModal.vue'
+import InstanceAdmonitions from '@/components/ui/instance/InstanceAdmonitions.vue'
 import InstanceSettingsModal from '@/components/ui/modal/InstanceSettingsModal.vue'
 import UpdateToPlayModal from '@/components/ui/modal/UpdateToPlayModal.vue'
 import { useInstanceConsole } from '@/composables/useInstanceConsole'
 import { trackEvent } from '@/helpers/analytics'
 import { get_project_v3 } from '@/helpers/cache.js'
 import { instance_listener, process_listener } from '@/helpers/events'
-import { install_existing_instance, install_pack_to_existing_instance } from '@/helpers/install'
+import {
+	install_existing_instance,
+	install_get_shared_instance_update_preview,
+	install_pack_to_existing_instance,
+} from '@/helpers/install'
 import { get, get_full_path, kill, run } from '@/helpers/instance'
 import { type InstanceContentData, loadInstanceContentData } from '@/helpers/instance-content'
 import { get_by_instance_id } from '@/helpers/process'
@@ -336,6 +373,7 @@ dayjs.extend(duration)
 dayjs.extend(relativeTime)
 
 const { addNotification, handleError } = injectNotificationManager()
+const auth = injectAuth()
 const { playServerProject } = injectServerInstall()
 const queryClient = useQueryClient()
 const route = useRoute()
@@ -380,6 +418,25 @@ const playersOnline = ref<number | undefined>(undefined)
 const ping = ref<number | undefined>(undefined)
 const loadingServerPing = ref(false)
 
+const sharedInstanceManager = computed(() => {
+	if (!instance.value?.shared_instance) return null
+
+	if (instance.value.shared_instance.role === 'owner') {
+		const user = auth.user.value
+		return {
+			username: user?.username ?? 'Example user',
+			avatarUrl: user?.avatar_url ?? undefined,
+			tintBy: user?.id ?? 'Example user',
+		}
+	}
+
+	return {
+		username: 'Example user',
+		avatarUrl: undefined,
+		tintBy: 'Example user',
+	}
+})
+
 watch(
 	() => router.currentRoute.value,
 	(nextRoute) => {
@@ -498,29 +555,50 @@ const isFixedRender = computed(() => renderMode.value === 'fixed')
 const contentSubpageProps = computed(() =>
 	isContentSubpageRoute() ? { preloadedContent: preloadedContent.value } : {},
 )
+const showShareTab = computed(() => {
+	const linkType = instance.value?.link?.type
 
-const tabs = computed(() => [
-	{
-		label: 'Content',
-		href: `${basePath.value}`,
-		icon: BoxesIcon,
-	},
-	{
-		label: 'Files',
-		href: `${basePath.value}/files`,
-		icon: FolderOpenIcon,
-	},
-	{
-		label: 'Worlds',
-		href: `${basePath.value}/worlds`,
-		icon: GlobeIcon,
-	},
-	{
-		label: 'Logs',
-		href: `${basePath.value}/logs`,
-		icon: TerminalSquareIcon,
-	},
-])
+	return (
+		instance.value?.shared_instance?.role !== 'member' &&
+		linkType !== 'server_project' &&
+		linkType !== 'server_project_modpack'
+	)
+})
+
+const tabs = computed(() => {
+	const instanceTabs = [
+		{
+			label: 'Content',
+			href: `${basePath.value}`,
+			icon: BoxesIcon,
+		},
+		{
+			label: 'Files',
+			href: `${basePath.value}/files`,
+			icon: FolderOpenIcon,
+		},
+		{
+			label: 'Worlds',
+			href: `${basePath.value}/worlds`,
+			icon: GlobeIcon,
+		},
+		{
+			label: 'Logs',
+			href: `${basePath.value}/logs`,
+			icon: TerminalSquareIcon,
+		},
+	]
+
+	if (showShareTab.value) {
+		instanceTabs.push({
+			label: 'Share',
+			href: `${basePath.value}/share`,
+			icon: UserPlusIcon,
+		})
+	}
+
+	return instanceTabs
+})
 
 if (instance.value) {
 	breadcrumbs.setName(
@@ -538,13 +616,7 @@ if (instance.value) {
 
 const options = ref<InstanceType<typeof ContextMenu> | null>(null)
 
-const startInstance = async (context: string) => {
-	if (!instance.value) return
-	if (updateToPlayModal.value?.hasUpdate) {
-		updateToPlayModal.value.show(instance.value)
-		return
-	}
-
+const launchInstance = async (context: string) => {
 	loading.value = true
 	try {
 		await run(route.params.id as string)
@@ -554,6 +626,7 @@ const startInstance = async (context: string) => {
 	}
 	loading.value = false
 
+	if (!instance.value) return
 	trackEvent('InstanceStart', {
 		loader: instance.value.loader,
 		game_version: instance.value.game_version,
@@ -561,6 +634,34 @@ const startInstance = async (context: string) => {
 	})
 }
 
+const startInstance = async (context: string) => {
+	if (!instance.value) return
+	if (instance.value.shared_instance?.role === 'member') {
+		let preview: Awaited<ReturnType<typeof install_get_shared_instance_update_preview>>
+		try {
+			preview = await install_get_shared_instance_update_preview(instance.value.id)
+		} catch (error) {
+			handleError(error as Error)
+			return
+		}
+
+		if (preview?.updateAvailable) {
+			updateToPlayModal.value?.showSharedInstance(instance.value, preview, async () => {
+				await fetchInstance()
+				await launchInstance(context)
+			})
+			return
+		}
+	}
+
+	if (updateToPlayModal.value?.hasUpdate) {
+		updateToPlayModal.value.show(instance.value)
+		return
+	}
+
+	await launchInstance(context)
+}
+
 const stopInstance = async (context: string) => {
 	stopping.value = true
 	await kill(route.params.id as string).catch(handleError)
diff --git a/apps/app-frontend/src/pages/instance/Mods.vue b/apps/app-frontend/src/pages/instance/Mods.vue
index 6bcff92a0e..b5468b92dd 100644
--- a/apps/app-frontend/src/pages/instance/Mods.vue
+++ b/apps/app-frontend/src/pages/instance/Mods.vue
@@ -15,11 +15,18 @@
 					:enable-toggle="!props.isServerInstance"
 					:busy="isBulkOperating"
 					:get-overflow-options="getOverflowOptions"
-					:switch-version="handleSwitchVersion"
+					:switch-version="isSharedMember ? undefined : handleSwitchVersion"
 					@update:enabled="handleModpackContentToggle"
 					@bulk:enable="(items) => handleModpackContentBulkToggle(items, true)"
 					@bulk:disable="(items) => handleModpackContentBulkToggle(items, false)"
 				/>
+				<ConfirmDisableModal
+					ref="sharedDisableConfirmModal"
+					:count="pendingModpackDisableItems.length"
+					:item-type="formatMessage(messages.contentTypeProject)"
+					:action-disabled="isInstanceBusy"
+					@disable="confirmPendingModpackContentDisable"
+				/>
 				<ConfirmModpackUpdateModal
 					ref="modpackUpdateConfirmModal"
 					:downgrade="isModpackUpdateDowngrade"
@@ -78,6 +85,7 @@ import {
 	type ContentModpackCardProject,
 	type ContentModpackCardVersion,
 	type ContentOwner,
+	ConfirmDisableModal,
 	ContentUpdaterModal,
 	defineMessages,
 	injectNotificationManager,
@@ -273,6 +281,7 @@ watch(
 const isModpackUpdating = ref(false)
 const isBulkOperating = ref(false)
 const isInstanceBusy = computed(() => props.instance?.install_stage !== 'installed')
+const isSharedMember = computed(() => props.instance.shared_instance?.role === 'member')
 const isPackLocked = computed(
 	() =>
 		props.instance?.link?.type === 'modrinth_modpack' ||
@@ -284,6 +293,8 @@ const exportModal = ref(null)
 const contentUpdaterModal = ref<InstanceType<typeof ContentUpdaterModal> | null>()
 const modpackContentModal = ref<InstanceType<typeof ModpackContentModal> | null>()
 const modpackUpdateConfirmModal = ref<InstanceType<typeof ConfirmModpackUpdateModal> | null>()
+const sharedDisableConfirmModal = ref<InstanceType<typeof ConfirmDisableModal> | null>()
+const pendingModpackDisableItems = ref<ContentItem[]>([])
 
 const modpackContentQueryKey = computed(() => ['linkedModpackContent', props.instance.id])
 const modpackContentQuery = useQuery({
@@ -362,8 +373,36 @@ function hasContentOperation(item: ContentItem) {
 	return keys.some((key) => activeContentOperationKeys.value.has(key))
 }
 
+function isSharedExtraContent(item: ContentItem) {
+	return isSharedMember.value && item.source_kind === 'shared_instance'
+}
+
+function isSharedLinkedModpackContent(item: ContentItem) {
+	return (
+		isSharedMember.value &&
+		(item.source_kind === 'modrinth_modpack' || item.source_kind === 'imported_modpack')
+	)
+}
+
+function canDeleteContent(item: ContentItem) {
+	return !isSharedLinkedModpackContent(item)
+}
+
+function shouldWarnBeforeDelete(items: ContentItem[]) {
+	return items.some(isSharedExtraContent)
+}
+
+function shouldWarnBeforeDisable(items: ContentItem[]) {
+	return items.some((item) => isSharedExtraContent(item) || isSharedLinkedModpackContent(item))
+}
+
 function canUpdateProject(item: ContentItem) {
-	return !!item.file_path && !!item.has_update && !!item.update_version_id
+	return (
+		!isSharedLinkedModpackContent(item) &&
+		!!item.file_path &&
+		!!item.has_update &&
+		!!item.update_version_id
+	)
 }
 
 function setContentItemBusy(item: ContentItem, busy: boolean, originalFileName = item.file_name) {
@@ -852,6 +891,7 @@ async function handleUpdate(id: string) {
 }
 
 async function handleSwitchVersion(item: ContentItem) {
+	if (isSharedLinkedModpackContent(item)) return
 	if (!item.project?.id || !item.version?.id) return
 
 	const requestId = beginUpdateRequest()
@@ -879,10 +919,32 @@ async function handleSwitchVersion(item: ContentItem) {
 }
 
 async function handleModpackContentToggle(item: ContentItem, enabled: boolean) {
+	if (!enabled && shouldWarnBeforeDisable([item])) {
+		pendingModpackDisableItems.value = [item]
+		sharedDisableConfirmModal.value?.show()
+		return
+	}
+
 	await toggleDisableDebounced(item, enabled)
 }
 
 async function handleModpackContentBulkToggle(items: ContentItem[], enabled: boolean) {
+	if (!enabled && shouldWarnBeforeDisable(items)) {
+		pendingModpackDisableItems.value = items
+		sharedDisableConfirmModal.value?.show()
+		return
+	}
+
+	await setModpackContentEnabled(items, enabled)
+}
+
+async function confirmPendingModpackContentDisable() {
+	const items = [...pendingModpackDisableItems.value]
+	pendingModpackDisableItems.value = []
+	await setModpackContentEnabled(items, false)
+}
+
+async function setModpackContentEnabled(items: ContentItem[], enabled: boolean) {
 	await Promise.all(items.map((item) => toggleDisableMod(item, enabled)))
 }
 
@@ -1325,6 +1387,11 @@ provideContentManager({
 	deleteItem: removeMod,
 	bulkDeleteItems: (items: ContentItem[]) =>
 		Promise.all(items.map((item) => removeMod(item))).then(() => {}),
+	canDeleteItem: canDeleteContent,
+	getDeleteWarningMode: (items: ContentItem[]) =>
+		shouldWarnBeforeDelete(items) ? 'shared-instance' : 'default',
+	getDisableWarningMode: (items: ContentItem[]) =>
+		shouldWarnBeforeDisable(items) ? 'shared-instance' : 'default',
 	getDeleteDependencyWarning,
 	refresh: () => initProjects('must_revalidate'),
 	browse: handleBrowseContent,
@@ -1371,6 +1438,9 @@ provideContentManager({
 			: undefined,
 		enabled: item.enabled,
 		installing: item.installing,
+		hideDelete: !canDeleteContent(item),
+		hideSwitchVersion: isSharedLinkedModpackContent(item),
+		hasUpdate: isSharedLinkedModpackContent(item) ? false : item.has_update,
 	}),
 	filterPersistKey: props.instance.id,
 })
diff --git a/apps/app-frontend/src/pages/instance/Share.vue b/apps/app-frontend/src/pages/instance/Share.vue
new file mode 100644
index 0000000000..fd1dfe48f9
--- /dev/null
+++ b/apps/app-frontend/src/pages/instance/Share.vue
@@ -0,0 +1,905 @@
+<template>
+	<div class="flex flex-col gap-4">
+		<InvitePlayersModal
+			ref="invitePlayersModal"
+			:header="inviteModalHeader"
+			:friends="inviteFriends"
+			:search-users="searchInviteUsers"
+			:user-profile-link="userProfileLink"
+			@invite="invitePlayer"
+			@cancel="cancelInvite"
+		/>
+		<ConfirmUnlinkModal
+			ref="shareUnlinkModal"
+			mode="share-instance"
+			:backup-tip="importedModpackBackupTip"
+			@unlink="unlinkImportedModpackForShare"
+		/>
+
+		<template v-if="rows.length > 0">
+			<div class="flex flex-col gap-4">
+				<div class="flex items-center gap-2">
+					<StyledInput
+						v-model="memberSearch"
+						:icon="SearchIcon"
+						:placeholder="`Search ${rows.length} users...`"
+						wrapper-class="min-w-0 flex-1"
+						input-class="!h-10"
+						clearable
+					/>
+					<ButtonStyled color="brand">
+						<button
+							class="flex !h-10 shrink-0 items-center gap-2"
+							@click="showInvitePlayers($event)"
+						>
+							<UserPlusIcon aria-hidden="true" />
+							{{ formatMessage(messages.inviteFriendsButton) }}
+						</button>
+					</ButtonStyled>
+				</div>
+
+				<div class="flex flex-wrap items-center gap-1.5">
+					<FilterIcon class="size-5 shrink-0 text-secondary" aria-hidden="true" />
+					<button
+						class="cursor-pointer rounded-full border border-solid px-3 py-1.5 text-base font-semibold leading-5 transition-all duration-100 active:scale-[0.97]"
+						:class="
+							methodFilter === 'all'
+								? 'border-green bg-brand-highlight text-brand'
+								: 'border-surface-5 bg-surface-4 text-primary hover:bg-surface-5'
+						"
+						:aria-pressed="methodFilter === 'all'"
+						@click="methodFilter = 'all'"
+					>
+						All
+					</button>
+					<button
+						v-for="option in methodFilterOptions"
+						:key="option.id"
+						class="cursor-pointer rounded-full border border-solid px-3 py-1.5 text-base font-semibold leading-5 transition-all duration-100 active:scale-[0.97]"
+						:class="
+							methodFilter === option.id
+								? 'border-green bg-brand-highlight text-brand'
+								: 'border-surface-5 bg-surface-4 text-primary hover:bg-surface-5'
+						"
+						:aria-pressed="methodFilter === option.id"
+						@click="toggleMethodFilter(option.id)"
+					>
+						{{ option.label }}
+					</button>
+				</div>
+			</div>
+
+			<Table
+				v-model:sort-column="sortColumn"
+				v-model:sort-direction="sortDirection"
+				:columns="columns"
+				:data="sortedRows"
+				row-key="id"
+				table-min-width="42rem"
+				@sort="handleTableSort"
+			>
+				<template #empty-state>
+					<div class="flex h-64 items-center justify-center text-secondary">
+						No users match your filters.
+					</div>
+				</template>
+
+				<template #cell-username="{ row }">
+					<div class="flex min-w-0 max-w-full items-center gap-2">
+						<AutoLink
+							v-tooltip="truncatedTooltip(usernameRefs[row.id], row.username)"
+							:to="userProfileLink(row.username)"
+							class="inline-flex max-w-full min-w-0 items-center gap-2 text-primary hover:underline"
+						>
+							<Avatar
+								:src="row.avatarUrl"
+								:alt="`${row.username}'s avatar`"
+								:tint-by="row.username"
+								size="24px"
+								circle
+								no-shadow
+							/>
+							<span
+								:ref="(element) => setUsernameRef(row.id, element)"
+								class="min-w-0 truncate font-medium"
+							>
+								{{ row.username }}
+							</span>
+						</AutoLink>
+					</div>
+				</template>
+
+				<template #cell-lastPlayed="{ row }">
+					<span v-if="row.lastPlayedAt" v-tooltip="formatDateTime(row.lastPlayedAt)">
+						{{ formatCompactRelativeTime(row.lastPlayedAt) }}
+					</span>
+					<span v-else>Never</span>
+				</template>
+
+				<template #cell-joined="{ row }">
+					<span
+						v-if="row.pending"
+						class="inline-flex h-7 items-center rounded-full border border-surface-5 border-solid bg-surface-4 px-2.5 py-1 text-sm font-semibold text-secondary"
+					>
+						Pending
+					</span>
+					<span v-else-if="row.joinedAt" v-tooltip="formatDateTime(row.joinedAt)">
+						{{ formatCompactRelativeTime(row.joinedAt) }}
+					</span>
+				</template>
+
+				<template #cell-method="{ row }">
+					<span class="inline-flex min-w-0 items-center gap-2">
+						<UserPlusIcon
+							v-if="row.method === 'direct'"
+							class="size-5 shrink-0"
+							aria-hidden="true"
+						/>
+						<LinkIcon v-else class="size-5 shrink-0" aria-hidden="true" />
+						<span class="min-w-0 truncate">{{ compactMethodLabels[row.method] }}</span>
+					</span>
+				</template>
+
+				<template #cell-actions="{ row }">
+					<div class="flex items-center justify-end">
+						<ButtonStyled v-if="row.pending" circular type="transparent">
+							<button
+								v-tooltip="'Revoke invite'"
+								:aria-label="`Revoke invite for ${row.username}`"
+								class="text-secondary hover:!filter-none hover:text-red focus-visible:!filter-none"
+								@click="removeRow(row.id)"
+							>
+								<XIcon aria-hidden="true" />
+							</button>
+						</ButtonStyled>
+						<ButtonStyled v-else circular type="transparent">
+							<OverflowMenu
+								:options="[
+									{
+										id: 'remove-user',
+										action: () => removeRow(row.id),
+										color: 'red',
+									},
+								]"
+							>
+								<MoreVerticalIcon aria-hidden="true" />
+								<span class="sr-only">Actions for {{ row.username }}</span>
+								<template #remove-user>
+									<XIcon aria-hidden="true" />
+									Revoke access
+								</template>
+							</OverflowMenu>
+						</ButtonStyled>
+					</div>
+				</template>
+			</Table>
+		</template>
+
+		<EmptyState v-else-if="!isSignedIn" type="empty-inbox">
+			<template #heading>{{ formatMessage(messages.signInToShareHeading) }}</template>
+			<template #description>{{ formatMessage(messages.signInToShareDescription) }}</template>
+			<template #actions>
+				<ButtonStyled color="brand">
+					<button class="!h-10" @click="signInToShare">
+						<LogInIcon aria-hidden="true" />
+						{{ formatMessage(messages.signInButton) }}
+					</button>
+				</ButtonStyled>
+			</template>
+		</EmptyState>
+
+		<EmptyState v-else type="empty-inbox">
+			<template #heading>{{ formatMessage(messages.noFriendsInvitedHeading) }}</template>
+			<template #description>{{ formatMessage(messages.noFriendsInvitedDescription) }}</template>
+			<template #actions>
+				<ButtonStyled color="brand">
+					<button class="!h-10" @click="showInvitePlayers($event)">
+						<UserPlusIcon aria-hidden="true" />
+						{{ formatMessage(messages.inviteFriendsButton) }}
+					</button>
+				</ButtonStyled>
+			</template>
+		</EmptyState>
+	</div>
+</template>
+
+<script setup lang="ts">
+import {
+	FilterIcon,
+	LinkIcon,
+	LogInIcon,
+	MoreVerticalIcon,
+	SearchIcon,
+	UserPlusIcon,
+	XIcon,
+} from '@modrinth/assets'
+import {
+	AutoLink,
+	Avatar,
+	ButtonStyled,
+	ConfirmUnlinkModal,
+	defineMessages,
+	EmptyState,
+	injectAuth,
+	injectNotificationManager,
+	type InvitePlayersInvitePayload,
+	InvitePlayersModal,
+	type InvitePlayersSearchUser,
+	type InvitePlayersUser,
+	OverflowMenu,
+	provideAppBackup,
+	type SortDirection,
+	StyledInput,
+	Table,
+	type TableColumn,
+	truncatedTooltip,
+	useFormatDateTime,
+	useRelativeTime,
+	useVIntl,
+} from '@modrinth/ui'
+import { useMutation, useQuery, useQueryClient } from '@tanstack/vue-query'
+import { openUrl } from '@tauri-apps/plugin-opener'
+import { computed, onUnmounted, ref, watch } from 'vue'
+
+import { get_user_many } from '@/helpers/cache.js'
+import { friend_listener } from '@/helpers/events.js'
+import {
+	add_friend,
+	createPendingFriend,
+	friendsQueryKey,
+	type FriendWithUserData,
+	getFriendsWithUserData,
+	getFriendUserId,
+	upsertCachedFriend,
+} from '@/helpers/friends.ts'
+import { install_duplicate_instance, installJobInstanceId } from '@/helpers/install'
+import {
+	edit,
+	get_shared_instance_users,
+	invite_shared_instance_users,
+	list,
+	remove_shared_instance_users,
+	type SharedInstanceUsers,
+} from '@/helpers/instance'
+import { get as getCredentials } from '@/helpers/mr_auth.ts'
+import type { GameInstance } from '@/helpers/types'
+import { search_user } from '@/helpers/users.ts'
+
+type ShareMethod = 'direct' | 'link'
+type MethodFilter = ShareMethod | 'all'
+type ShareTableColumn = 'username' | 'lastPlayed' | 'joined' | 'method' | 'actions'
+
+type ShareRow = {
+	id: string
+	username: string
+	avatarUrl?: string
+	lastPlayedAt: Date | null
+	joinedAt: Date | null
+	method: ShareMethod
+	pending?: boolean
+}
+
+const props = defineProps<{
+	instance: GameInstance
+}>()
+
+const auth = injectAuth()
+const { handleError } = injectNotificationManager()
+const invitePlayersModal = ref<InstanceType<typeof InvitePlayersModal> | null>(null)
+const shareUnlinkModal = ref<InstanceType<typeof ConfirmUnlinkModal> | null>(null)
+const memberSearch = ref('')
+const methodFilter = ref<MethodFilter>('all')
+const sortColumn = ref<string | undefined>('joined')
+const sortDirection = ref<SortDirection>('desc')
+const usernameRefs = ref<Record<string, HTMLElement | null>>({})
+const importedModpackUnlinkedForShare = ref(false)
+
+const pendingRows = ref<Record<string, ShareRow>>({})
+
+const messages = defineMessages({
+	signInToShareHeading: {
+		id: 'app.instance.share.sign-in.heading',
+		defaultMessage: 'Sign in to share',
+	},
+	signInToShareDescription: {
+		id: 'app.instance.share.sign-in.description',
+		defaultMessage: 'You need a Modrinth account to share instances.',
+	},
+	signInButton: {
+		id: 'app.instance.share.sign-in.button',
+		defaultMessage: 'Sign in',
+	},
+	noFriendsInvitedHeading: {
+		id: 'app.instance.share.empty.heading',
+		defaultMessage: 'No friends invited',
+	},
+	noFriendsInvitedDescription: {
+		id: 'app.instance.share.empty.description',
+		defaultMessage: 'You can share this instance with your friends!',
+	},
+	inviteFriendsButton: {
+		id: 'app.instance.share.empty.invite-friends-button',
+		defaultMessage: 'Invite friends',
+	},
+	shareModalHeader: {
+		id: 'app.instance.share.invite-modal.heading',
+		defaultMessage: 'Share {name}',
+	},
+})
+
+const { formatMessage } = useVIntl()
+const formatCompactRelativeTime = useRelativeTime({ style: 'narrow' })
+const formatDateTime = useFormatDateTime({ dateStyle: 'medium', timeStyle: 'short' })
+const queryClient = useQueryClient()
+const currentUserId = computed(() => auth.user.value?.id ?? null)
+const isSignedIn = computed(() => !!auth.session_token.value)
+const inviteModalHeader = computed(() =>
+	formatMessage(messages.shareModalHeader, { name: props.instance.name }),
+)
+const shareRoutePath = computed(() => `/instance/${encodeURIComponent(props.instance.id)}/share`)
+const friendsKey = computed(() => friendsQueryKey(currentUserId.value))
+const sharedUsersKey = computed(() => ['sharedInstanceUsers', props.instance.id] as const)
+const requiresUnlinkBeforeShare = computed(
+	() =>
+		props.instance.link?.type === 'imported_modpack' &&
+		!props.instance.shared_instance &&
+		!importedModpackUnlinkedForShare.value,
+)
+const importedModpackBackupTip = computed(() => {
+	const link = props.instance.link
+	if (link?.type !== 'imported_modpack') return undefined
+
+	return link.name ?? link.filename ?? undefined
+})
+const friendsQuery = useQuery({
+	queryKey: friendsKey,
+	queryFn: async () => getFriendsWithUserData(await getCredentials()),
+	enabled: () => isSignedIn.value && !!currentUserId.value,
+	staleTime: 30_000,
+})
+const userFriends = computed(() => friendsQuery.data.value ?? [])
+const sharedUsersQuery = useQuery({
+	queryKey: sharedUsersKey,
+	queryFn: loadSharedRows,
+	enabled: () => isSignedIn.value && !!props.instance.id,
+	staleTime: Infinity,
+})
+const sharedRows = computed(() => sharedUsersQuery.data.value ?? [])
+const rows = computed(() => {
+	const sharedKeys = new Set(sharedRows.value.map((row) => normalizeInviteKey(row.id)))
+	const pending = Object.values(pendingRows.value).filter(
+		(row) => !sharedKeys.has(normalizeInviteKey(row.id)),
+	)
+
+	return [...pending, ...sharedRows.value]
+})
+
+const methodLabels: Record<ShareMethod, string> = {
+	direct: 'Direct invite',
+	link: 'Share link',
+}
+
+const compactMethodLabels: Record<ShareMethod, string> = {
+	direct: 'Direct invite',
+	link: 'Share link',
+}
+
+const columns: TableColumn<ShareTableColumn>[] = [
+	{
+		key: 'username',
+		label: 'Username',
+		width: 'clamp(14rem, 30%, 26rem)',
+		enableSorting: true,
+		headerClass: '!pr-3',
+		cellClass: '!pr-3',
+	},
+	{
+		key: 'lastPlayed',
+		label: 'Last played',
+		width: 'clamp(7rem, 15%, 13rem)',
+		enableSorting: true,
+		headerClass: 'whitespace-nowrap !px-2',
+		cellClass: 'whitespace-nowrap !px-2',
+	},
+	{
+		key: 'joined',
+		label: 'Joined',
+		width: 'clamp(7rem, 14%, 12rem)',
+		enableSorting: true,
+		defaultSortDirection: 'desc',
+		headerClass: 'whitespace-nowrap !px-2',
+		cellClass: 'whitespace-nowrap !px-2',
+	},
+	{
+		key: 'method',
+		label: 'Method',
+		enableSorting: true,
+		headerClass: 'whitespace-nowrap !px-2',
+		cellClass: 'whitespace-nowrap !px-2',
+	},
+	{
+		key: 'actions',
+		label: 'Actions',
+		align: 'right',
+		width: 'clamp(5.5rem, 7%, 7rem)',
+		headerClass: 'whitespace-nowrap !pl-2 !pr-4',
+		cellClass: 'whitespace-nowrap !pl-2 !pr-4',
+	},
+]
+
+const methodFilterOptions = computed<Array<{ id: ShareMethod; label: string }>>(() => [
+	{ id: 'direct', label: methodLabels.direct },
+	{ id: 'link', label: methodLabels.link },
+])
+
+const invitedRows = computed(() => {
+	const invited = new Map<string, ShareRow>()
+
+	for (const row of rows.value) {
+		invited.set(normalizeInviteKey(row.id), row)
+		invited.set(normalizeInviteKey(row.username), row)
+	}
+
+	return invited
+})
+
+const inviteFriends = computed<InvitePlayersUser[]>(() =>
+	userFriends.value
+		.filter((friend) => friend.username)
+		.map((friend) => {
+			const id = getFriendUserId(friend, currentUserId.value)
+			const invitedRow =
+				invitedRows.value.get(normalizeInviteKey(id)) ??
+				invitedRows.value.get(normalizeInviteKey(friend.username))
+
+			return {
+				id,
+				username: friend.username,
+				avatarUrl: friend.avatar,
+				online: friend.online,
+				status: friend.accepted
+					? invitedRow
+						? invitedRow.pending
+							? 'pending'
+							: 'added'
+						: 'available'
+					: 'requested',
+			} satisfies InvitePlayersUser
+		}),
+)
+
+const inviteFriendKeys = computed(() => {
+	const keys = new Set<string>()
+
+	for (const friend of inviteFriends.value) {
+		keys.add(normalizeInviteKey(friend.id))
+		keys.add(normalizeInviteKey(friend.username))
+	}
+
+	return keys
+})
+
+const filteredRows = computed(() => {
+	const normalizedSearch = memberSearch.value.trim().toLowerCase()
+
+	return rows.value.filter((row) => {
+		if (methodFilter.value !== 'all' && row.method !== methodFilter.value) return false
+		if (!normalizedSearch) return true
+
+		return [
+			row.username,
+			formattedLastPlayed(row),
+			formattedJoined(row),
+			methodLabels[row.method],
+			compactMethodLabels[row.method],
+		].some((value) => value.toLowerCase().includes(normalizedSearch))
+	})
+})
+
+const sortedRows = computed(() => [...filteredRows.value].sort(compareRows))
+
+function compareRows(a: ShareRow, b: ShareRow) {
+	const column = sortColumn.value
+	const direction = sortDirection.value
+
+	switch (column) {
+		case 'username':
+			return compareString(a.username, b.username, direction)
+		case 'lastPlayed':
+			return compareDate(a.lastPlayedAt, b.lastPlayedAt, direction)
+		case 'method':
+			return compareString(compactMethodLabels[a.method], compactMethodLabels[b.method], direction)
+		default:
+			return compareJoined(a, b, direction)
+	}
+}
+
+function compareJoined(a: ShareRow, b: ShareRow, direction: SortDirection) {
+	const compared = joinedSortValue(a) - joinedSortValue(b) || a.username.localeCompare(b.username)
+	return direction === 'asc' ? compared : -compared
+}
+
+function joinedSortValue(row: ShareRow) {
+	return row.pending
+		? Number.MAX_SAFE_INTEGER
+		: (row.joinedAt?.getTime() ?? Number.NEGATIVE_INFINITY)
+}
+
+function compareDate(a: Date | null, b: Date | null, direction: SortDirection) {
+	const compared = compareDateValue(a, b)
+	return direction === 'asc' ? compared : -compared
+}
+
+function compareDateValue(a: Date | null, b: Date | null) {
+	const aTime = a?.getTime() ?? Number.NEGATIVE_INFINITY
+	const bTime = b?.getTime() ?? Number.NEGATIVE_INFINITY
+	return aTime - bTime
+}
+
+function compareString(a: string, b: string, direction: SortDirection) {
+	const compared = a.localeCompare(b)
+	return direction === 'asc' ? compared : -compared
+}
+
+function handleTableSort(column: string, direction: SortDirection) {
+	sortColumn.value = column
+	sortDirection.value = direction
+}
+
+function toggleMethodFilter(filter: ShareMethod) {
+	methodFilter.value = methodFilter.value === filter ? 'all' : filter
+}
+
+async function searchInviteUsers(query: string): Promise<InvitePlayersSearchUser[]> {
+	const users = await search_user(query)
+
+	return users
+		.filter((user) => user.id !== currentUserId.value)
+		.filter(
+			(user) =>
+				!inviteFriendKeys.value.has(normalizeInviteKey(user.id)) &&
+				!inviteFriendKeys.value.has(normalizeInviteKey(user.username)),
+		)
+		.map((user) => ({
+			id: user.id,
+			username: user.username,
+			avatarUrl: user.avatar_url || undefined,
+		}))
+}
+
+type FriendsMutationContext = {
+	queryKey: ReturnType<typeof friendsQueryKey>
+	previousFriends?: FriendWithUserData[]
+}
+
+type SharedRowsMutationContext = {
+	queryKey: typeof sharedUsersKey.value
+	previousRows?: ShareRow[]
+}
+
+const addFriendMutation = useMutation({
+	mutationFn: (user: InvitePlayersUser) => add_friend(user.id),
+	onMutate: async (user): Promise<FriendsMutationContext> => {
+		const queryKey = friendsKey.value
+		await queryClient.cancelQueries({ queryKey })
+		const previousFriends = queryClient.getQueryData<FriendWithUserData[]>(queryKey)
+
+		queryClient.setQueryData<FriendWithUserData[]>(queryKey, (friends = []) =>
+			upsertCachedFriend(
+				friends,
+				createPendingFriend(user, currentUserId.value),
+				currentUserId.value,
+			),
+		)
+
+		return { queryKey, previousFriends }
+	},
+	onError: (error, _user, context) => {
+		restoreFriendsQuery(context)
+		handleError(toError(error))
+	},
+	onSettled: (_data, _error, _user, context) => {
+		void queryClient.invalidateQueries({ queryKey: context?.queryKey ?? friendsKey.value })
+	},
+})
+
+const inviteShareMutation = useMutation({
+	mutationFn: async (user: InvitePlayersUser) => {
+		await invite_shared_instance_users(props.instance.id, [user.id])
+	},
+	onMutate: async (user): Promise<SharedRowsMutationContext> => {
+		const queryKey = sharedUsersKey.value
+		await queryClient.cancelQueries({ queryKey })
+		const previousRows = queryClient.getQueryData<ShareRow[]>(queryKey)
+		setPendingRow(user)
+
+		return { queryKey, previousRows }
+	},
+	onError: (error, user, context) => {
+		removePendingRow(user.id)
+		restoreSharedRowsQuery(context)
+		handleError(toError(error))
+	},
+	onSuccess: (_data, user) => {
+		upsertSharedRow(inviteUserToShareRow(user))
+		removePendingRow(user.id)
+	},
+})
+
+const removeShareMutation = useMutation({
+	mutationFn: async (id: string) => {
+		return await remove_shared_instance_users(props.instance.id, [id])
+	},
+	onMutate: async (id): Promise<SharedRowsMutationContext> => {
+		const queryKey = sharedUsersKey.value
+		await queryClient.cancelQueries({ queryKey })
+		const previousRows = queryClient.getQueryData<ShareRow[]>(queryKey)
+		queryClient.setQueryData<ShareRow[]>(queryKey, (rows = []) =>
+			rows.filter((row) => normalizeInviteKey(row.id) !== normalizeInviteKey(id)),
+		)
+
+		return { queryKey, previousRows }
+	},
+	onError: (error, _id, context) => {
+		restoreSharedRowsQuery(context)
+		handleError(toError(error))
+	},
+	onSuccess: async (users) => {
+		try {
+			queryClient.setQueryData<ShareRow[]>(sharedUsersKey.value, await sharedUsersToRows(users))
+		} catch (error) {
+			handleError(toError(error))
+			await queryClient.invalidateQueries({ queryKey: sharedUsersKey.value })
+		}
+	},
+})
+
+async function loadSharedRows(): Promise<ShareRow[]> {
+	return sharedUsersToRows(await get_shared_instance_users(props.instance.id))
+}
+
+async function sharedUsersToRows(users: SharedInstanceUsers): Promise<ShareRow[]> {
+	if (users.user_ids.length === 0) return []
+
+	const profiles = (await get_user_many(users.user_ids)) as Array<{
+		id: string
+		username?: string
+		avatar_url?: string | null
+	}>
+
+	return users.user_ids.map((id) => {
+		const profile = profiles.find((user) => user.id === id)
+
+		return {
+			id,
+			username: profile?.username ?? id,
+			avatarUrl: profile?.avatar_url ?? undefined,
+			lastPlayedAt: null,
+			joinedAt: null,
+			method: 'direct',
+		} satisfies ShareRow
+	})
+}
+
+function invitePlayer(payload: InvitePlayersInvitePayload) {
+	const user = payload.user
+	if (payload.source === 'search') {
+		addPendingFriend(user)
+	}
+
+	inviteShareUser(user)
+}
+
+function inviteShareUser(user: InvitePlayersUser) {
+	const existingRow = findInviteRow(user.id, user.username)
+	if (existingRow) {
+		return
+	}
+
+	inviteShareMutation.mutate(user)
+}
+
+function addPendingFriend(user: InvitePlayersUser) {
+	if (findInviteFriend(user.id, user.username)) return
+
+	addFriendMutation.mutate(user)
+}
+
+function cancelInvite(user: InvitePlayersUser) {
+	const existingRow = findInviteRow(user.id, user.username)
+	if (existingRow) {
+		removeRow(existingRow.id)
+	}
+}
+
+function showInvitePlayers(event?: MouseEvent) {
+	if (requiresUnlinkBeforeShare.value) {
+		shareUnlinkModal.value?.show()
+		return
+	}
+
+	invitePlayersModal.value?.show(event)
+}
+
+async function unlinkImportedModpackForShare() {
+	try {
+		await edit(props.instance.id, {
+			link: null as unknown as undefined,
+		})
+		importedModpackUnlinkedForShare.value = true
+		await queryClient.invalidateQueries({ queryKey: ['linkedModpackInfo', props.instance.id] })
+		invitePlayersModal.value?.show()
+	} catch (error) {
+		handleError(toError(error))
+	}
+}
+
+function removeRow(id: string) {
+	if (pendingRows.value[id]) {
+		removePendingRow(id)
+		return
+	}
+
+	removeShareMutation.mutate(id)
+}
+
+function setPendingRow(user: InvitePlayersUser) {
+	pendingRows.value = {
+		...pendingRows.value,
+		[user.id]: {
+			id: user.id,
+			username: user.username,
+			avatarUrl: user.avatarUrl,
+			lastPlayedAt: null,
+			joinedAt: null,
+			method: 'direct',
+			pending: true,
+		},
+	}
+}
+
+function removePendingRow(id: string) {
+	const { [id]: _removed, ...rest } = pendingRows.value
+	pendingRows.value = rest
+}
+
+function inviteUserToShareRow(user: InvitePlayersUser): ShareRow {
+	return {
+		id: user.id,
+		username: user.username,
+		avatarUrl: user.avatarUrl ?? undefined,
+		lastPlayedAt: null,
+		joinedAt: null,
+		method: 'direct',
+	}
+}
+
+function upsertSharedRow(row: ShareRow) {
+	queryClient.setQueryData<ShareRow[]>(sharedUsersKey.value, (rows = []) => {
+		const normalizedId = normalizeInviteKey(row.id)
+		const withoutExisting = rows.filter(
+			(existing) => normalizeInviteKey(existing.id) !== normalizedId,
+		)
+
+		return [row, ...withoutExisting]
+	})
+}
+
+function restoreFriendsQuery(context?: FriendsMutationContext) {
+	if (!context) return
+
+	if (context.previousFriends === undefined) {
+		queryClient.removeQueries({ queryKey: context.queryKey, exact: true })
+		return
+	}
+
+	queryClient.setQueryData(context.queryKey, context.previousFriends)
+}
+
+function restoreSharedRowsQuery(context?: SharedRowsMutationContext) {
+	if (!context) return
+
+	if (context.previousRows === undefined) {
+		queryClient.removeQueries({ queryKey: context.queryKey, exact: true })
+		return
+	}
+
+	queryClient.setQueryData(context.queryKey, context.previousRows)
+}
+
+function userProfileLink(username: string) {
+	if (!username || username.includes('@')) return undefined
+	return () => openUrl(`https://modrinth.com/user/${encodeURIComponent(username)}`)
+}
+
+function signInToShare() {
+	void auth.requestSignIn(shareRoutePath.value)
+}
+
+function setUsernameRef(id: string, element: Element | null) {
+	const nextElement = element instanceof HTMLElement ? element : null
+	if (usernameRefs.value[id] === nextElement) return
+
+	usernameRefs.value = {
+		...usernameRefs.value,
+		[id]: nextElement,
+	}
+}
+
+function formattedLastPlayed(row: ShareRow) {
+	return row.lastPlayedAt ? formatCompactRelativeTime(row.lastPlayedAt) : 'Never'
+}
+
+function formattedJoined(row: ShareRow) {
+	return row.pending ? 'Pending' : row.joinedAt ? formatCompactRelativeTime(row.joinedAt) : ''
+}
+
+function findInviteRow(id: string, username: string) {
+	const normalizedId = normalizeInviteKey(id)
+	const normalizedUsername = normalizeInviteKey(username)
+
+	return rows.value.find(
+		(row) =>
+			normalizeInviteKey(row.id) === normalizedId ||
+			normalizeInviteKey(row.username) === normalizedUsername,
+	)
+}
+
+function findInviteFriend(id: string, username: string) {
+	const normalizedId = normalizeInviteKey(id)
+	const normalizedUsername = normalizeInviteKey(username)
+
+	return inviteFriends.value.find(
+		(friend) =>
+			normalizeInviteKey(friend.id) === normalizedId ||
+			normalizeInviteKey(friend.username) === normalizedUsername,
+	)
+}
+
+function normalizeInviteKey(value: string) {
+	return value.trim().toLowerCase()
+}
+
+function toError(error: unknown) {
+	if (error instanceof Error) return error
+	if (typeof error === 'string') return new Error(error)
+	if (error && typeof error === 'object') {
+		const record = error as Record<string, unknown>
+		const message = record.message ?? record.error
+		if (typeof message === 'string') return new Error(message)
+		return new Error(JSON.stringify(error))
+	}
+	return new Error(String(error))
+}
+
+watch(
+	() => props.instance.id,
+	() => {
+		importedModpackUnlinkedForShare.value = false
+	},
+)
+
+provideAppBackup({
+	async createBackup() {
+		const allInstances = await list()
+		const prefix = `${props.instance.name} - Backup #`
+		const existingNums = allInstances
+			.filter((instance) => instance.name.startsWith(prefix))
+			.map((instance) => parseInt(instance.name.slice(prefix.length), 10))
+			.filter((value) => !isNaN(value))
+		const nextNum = existingNums.length > 0 ? Math.max(...existingNums) + 1 : 1
+		const job = await install_duplicate_instance(props.instance.id)
+		const newInstanceId = installJobInstanceId(job)
+		if (newInstanceId) {
+			await edit(newInstanceId, { name: `${prefix}${nextNum}` })
+		}
+	},
+})
+
+const unlistenFriends = await friend_listener(() => {
+	void queryClient.invalidateQueries({ queryKey: friendsKey.value })
+})
+onUnmounted(() => {
+	unlistenFriends()
+})
+</script>
diff --git a/apps/app-frontend/src/pages/instance/index.js b/apps/app-frontend/src/pages/instance/index.js
index b96705e883..ad9b0be8c0 100644
--- a/apps/app-frontend/src/pages/instance/index.js
+++ b/apps/app-frontend/src/pages/instance/index.js
@@ -3,6 +3,7 @@ import Index from './Index.vue'
 import Logs from './Logs.vue'
 import Mods from './Mods.vue'
 import Overview from './Overview.vue'
+import Share from './Share.vue'
 import Worlds from './Worlds.vue'
 
-export { Files, Index, Logs, Mods, Overview, Worlds }
+export { Files, Index, Logs, Mods, Overview, Share, Worlds }
diff --git a/apps/app-frontend/src/routes.js b/apps/app-frontend/src/routes.js
index 5919805754..2baa1edd06 100644
--- a/apps/app-frontend/src/routes.js
+++ b/apps/app-frontend/src/routes.js
@@ -215,6 +215,15 @@ export default new createRouter({
 						breadcrumb: [{ name: '?Instance', link: '/instance/{id}/' }, { name: 'Worlds' }],
 					},
 				},
+				{
+					path: 'share',
+					name: 'InstanceShare',
+					component: Instance.Share,
+					meta: {
+						useRootContext: true,
+						breadcrumb: [{ name: '?Instance', link: '/instance/{id}/' }, { name: 'Share' }],
+					},
+				},
 				{
 					path: '',
 					name: 'Mods',
diff --git a/apps/app/build.rs b/apps/app/build.rs
index cda15ffcdf..9e9d9e9d7c 100644
--- a/apps/app/build.rs
+++ b/apps/app/build.rs
@@ -148,6 +148,10 @@ fn main() {
                         "install_get_modpack_preview",
                         "install_create_instance",
                         "install_create_modpack_instance",
+                        "install_get_shared_instance_preview",
+                        "install_get_shared_instance_update_preview",
+                        "install_shared_instance",
+                        "install_update_shared_instance",
                         "install_import_instance",
                         "install_duplicate_instance",
                         "install_existing_instance",
@@ -209,6 +213,10 @@ fn main() {
                         "instance_kill",
                         "instance_edit",
                         "instance_edit_icon",
+                        "instance_share_get_users",
+                        "instance_share_invite_users",
+                        "instance_share_remove_users",
+                        "instance_share_publish",
                         "instance_export_mrpack",
                         "instance_get_pack_export_candidates",
                     ])
@@ -250,6 +258,14 @@ fn main() {
                         DefaultPermissionRule::AllowAllCommands,
                     ),
             )
+            .plugin(
+                "users",
+                InlinedPlugin::new()
+                    .commands(&["search_user"])
+                    .default_permission(
+                        DefaultPermissionRule::AllowAllCommands,
+                    ),
+            )
             .plugin(
                 "utils",
                 InlinedPlugin::new()
diff --git a/apps/app/capabilities/plugins.json b/apps/app/capabilities/plugins.json
index 2cb2521766..4a30955f70 100644
--- a/apps/app/capabilities/plugins.json
+++ b/apps/app/capabilities/plugins.json
@@ -107,6 +107,7 @@
 		"settings:default",
 		"shortcuts:default",
 		"tags:default",
+		"users:default",
 		"utils:default",
 		"ads:default",
 		"friends:default",
diff --git a/apps/app/src/api/install.rs b/apps/app/src/api/install.rs
index 393f4923c4..f010e61cb5 100644
--- a/apps/app/src/api/install.rs
+++ b/apps/app/src/api/install.rs
@@ -6,6 +6,9 @@ use theseus::data::ModLoader;
 use theseus::install::{
     InstallJobSnapshot, InstallModpackPreview, InstallPostInstallEdit,
 };
+use theseus::instance::{
+    SharedInstanceInstallPreview, SharedInstanceUpdatePreview,
+};
 use theseus::pack::import::ImportLauncherType;
 use theseus::pack::install_from::CreatePackLocation;
 use uuid::Uuid;
@@ -16,6 +19,10 @@ pub fn init<R: tauri::Runtime>() -> tauri::plugin::TauriPlugin<R> {
             install_get_modpack_preview,
             install_create_instance,
             install_create_modpack_instance,
+            install_get_shared_instance_preview,
+            install_get_shared_instance_update_preview,
+            install_shared_instance,
+            install_update_shared_instance,
             install_import_instance,
             install_duplicate_instance,
             install_existing_instance,
@@ -100,6 +107,46 @@ pub async fn install_create_modpack_instance(
     .await?)
 }
 
+#[tauri::command]
+pub async fn install_get_shared_instance_preview(
+    shared_instance_id: String,
+    name: String,
+) -> Result<SharedInstanceInstallPreview> {
+    Ok(theseus::instance::get_shared_instance_install_preview(
+        &shared_instance_id,
+        name,
+    )
+    .await?)
+}
+
+#[tauri::command]
+pub async fn install_get_shared_instance_update_preview(
+    instance_id: String,
+) -> Result<Option<SharedInstanceUpdatePreview>> {
+    Ok(
+        theseus::instance::get_shared_instance_update_preview(&instance_id)
+            .await?,
+    )
+}
+
+#[tauri::command]
+pub async fn install_shared_instance(
+    shared_instance_id: String,
+    name: String,
+) -> Result<InstallJobSnapshot> {
+    Ok(
+        theseus::instance::install_shared_instance(&shared_instance_id, name)
+            .await?,
+    )
+}
+
+#[tauri::command]
+pub async fn install_update_shared_instance(
+    instance_id: String,
+) -> Result<InstallJobSnapshot> {
+    Ok(theseus::instance::update_shared_instance(&instance_id).await?)
+}
+
 #[tauri::command]
 pub async fn install_import_instance(
     launcher_type: ImportLauncherType,
diff --git a/apps/app/src/api/instance.rs b/apps/app/src/api/instance.rs
index 0ee6e3a1e9..bcabfc2ba8 100644
--- a/apps/app/src/api/instance.rs
+++ b/apps/app/src/api/instance.rs
@@ -10,6 +10,8 @@ use theseus::data::{
     EditInstance as CoreEditInstance, InstanceInstallCandidate,
     InstanceInstallTarget, InstanceLaunchOverridesPatch,
     InstanceLink as CoreInstanceLink, InstanceMetadata, LinkedModpackInfo,
+    SharedInstanceAttachment as CoreSharedInstanceAttachment,
+    SharedInstanceRole,
 };
 use theseus::instance::InstallProjectWithDependenciesRequest;
 use theseus::instance::QuickPlayType;
@@ -49,6 +51,10 @@ pub fn init<R: tauri::Runtime>() -> tauri::plugin::TauriPlugin<R> {
             instance_kill,
             instance_edit,
             instance_edit_icon,
+            instance_share_get_users,
+            instance_share_invite_users,
+            instance_share_remove_users,
+            instance_share_publish,
             instance_export_mrpack,
             instance_get_pack_export_candidates,
         ])
@@ -69,6 +75,7 @@ pub struct Instance {
     pub loader_version: Option<String>,
     pub groups: Vec<String>,
     pub link: Option<InstanceLink>,
+    pub shared_instance: Option<SharedInstanceAttachment>,
     pub update_channel: ReleaseChannel,
     pub created: chrono::DateTime<chrono::Utc>,
     pub modified: chrono::DateTime<chrono::Utc>,
@@ -113,9 +120,28 @@ pub enum InstanceLink {
         instance_ids: Vec<String>,
         active_instance_id: Option<String>,
     },
-    SharedInstance {
-        shared_instance_id: String,
-    },
+    SharedInstance,
+}
+
+#[derive(Serialize, Debug, Clone)]
+pub struct SharedInstanceAttachment {
+    pub id: String,
+    pub role: SharedInstanceRole,
+    pub status: String,
+    pub applied_version: Option<i32>,
+    pub latest_version: Option<i32>,
+}
+
+impl From<CoreSharedInstanceAttachment> for SharedInstanceAttachment {
+    fn from(attachment: CoreSharedInstanceAttachment) -> Self {
+        Self {
+            id: attachment.id.to_string(),
+            role: attachment.role,
+            status: attachment.status.as_str().to_string(),
+            applied_version: attachment.applied_version,
+            latest_version: attachment.latest_version,
+        }
+    }
 }
 
 #[derive(Serialize, Deserialize, Debug, Clone)]
@@ -200,6 +226,7 @@ impl From<InstanceMetadata> for Instance {
             loader_version: metadata.applied_content_set.loader_version,
             groups: metadata.groups,
             link: InstanceLink::from_core(metadata.link),
+            shared_instance: metadata.shared_instance.map(Into::into),
             update_channel: metadata.instance.update_channel,
             created: metadata.instance.created,
             modified: metadata.instance.modified,
@@ -267,11 +294,7 @@ impl InstanceLink {
                     .collect(),
                 active_instance_id: active_instance_id.map(|id| id.to_string()),
             }),
-            CoreInstanceLink::SharedInstance { shared_instance_id } => {
-                Some(Self::SharedInstance {
-                    shared_instance_id: shared_instance_id.to_string(),
-                })
-            }
+            CoreInstanceLink::SharedInstance => Some(Self::SharedInstance),
         }
     }
 
@@ -344,19 +367,7 @@ impl InstanceLink {
                     })
                     .transpose()?,
             }),
-            Self::SharedInstance { shared_instance_id } => {
-                Ok(CoreInstanceLink::SharedInstance {
-                    shared_instance_id: shared_instance_id.parse().map_err(
-                        |err| {
-                            theseus::Error::from(
-                                theseus::ErrorKind::InputError(format!(
-                                    "Invalid shared instance id: {err}"
-                                )),
-                            )
-                        },
-                    )?,
-                })
-            }
+            Self::SharedInstance => Ok(CoreInstanceLink::SharedInstance),
         }
     }
 }
@@ -738,3 +749,41 @@ pub async fn instance_edit_icon(
     theseus::instance::edit_icon(instance_id, icon_path).await?;
     Ok(())
 }
+
+#[tauri::command]
+pub async fn instance_share_get_users(
+    instance_id: &str,
+) -> Result<theseus::instance::SharedInstanceUsers> {
+    Ok(theseus::instance::get_shared_instance_users(instance_id).await?)
+}
+
+#[tauri::command]
+pub async fn instance_share_invite_users(
+    instance_id: &str,
+    user_ids: Vec<String>,
+) -> Result<theseus::instance::SharedInstanceUsers> {
+    Ok(
+        theseus::instance::invite_shared_instance_users(instance_id, user_ids)
+            .await?,
+    )
+}
+
+#[tauri::command]
+pub async fn instance_share_remove_users(
+    instance_id: &str,
+    user_ids: Vec<String>,
+) -> Result<theseus::instance::SharedInstanceUsers> {
+    Ok(
+        theseus::instance::remove_shared_instance_users(instance_id, user_ids)
+            .await?,
+    )
+}
+
+#[tauri::command]
+pub async fn instance_share_publish(
+    instance_id: &str,
+) -> Result<SharedInstanceAttachment> {
+    Ok(theseus::instance::publish_shared_instance(instance_id)
+        .await?
+        .into())
+}
diff --git a/apps/app/src/api/mod.rs b/apps/app/src/api/mod.rs
index 2d45357cbf..a3820d44bc 100644
--- a/apps/app/src/api/mod.rs
+++ b/apps/app/src/api/mod.rs
@@ -15,6 +15,7 @@ pub mod process;
 pub mod settings;
 pub mod shortcuts;
 pub mod tags;
+pub mod users;
 pub mod utils;
 
 pub mod ads;
diff --git a/apps/app/src/api/users.rs b/apps/app/src/api/users.rs
new file mode 100644
index 0000000000..b4c5dba75a
--- /dev/null
+++ b/apps/app/src/api/users.rs
@@ -0,0 +1,13 @@
+use crate::api::Result;
+use theseus::users::SearchUser;
+
+#[tauri::command]
+pub async fn search_user(query: &str) -> Result<Vec<SearchUser>> {
+    Ok(theseus::users::search_user(query).await?)
+}
+
+pub fn init<R: tauri::Runtime>() -> tauri::plugin::TauriPlugin<R> {
+    tauri::plugin::Builder::new("users")
+        .invoke_handler(tauri::generate_handler![search_user])
+        .build()
+}
diff --git a/apps/app/src/main.rs b/apps/app/src/main.rs
index 96d6b9e33b..4cc30cb563 100644
--- a/apps/app/src/main.rs
+++ b/apps/app/src/main.rs
@@ -243,6 +243,7 @@ fn main() {
         .plugin(api::settings::init())
         .plugin(api::shortcuts::init())
         .plugin(api::tags::init())
+        .plugin(api::users::init())
         .plugin(api::utils::init())
         .plugin(api::cache::init())
         .plugin(api::files::init())
diff --git a/packages/app-lib/.env.local b/packages/app-lib/.env.local
index 198438ffe2..0fa04b5dd6 100644
--- a/packages/app-lib/.env.local
+++ b/packages/app-lib/.env.local
@@ -1,5 +1,6 @@
 MODRINTH_URL=http://localhost:3000/
 MODRINTH_API_BASE_URL=http://localhost:8000/
+SHARED_INSTANCES_API_BASE_URL=https://staging-shared-instances.modrinth.com/
 MODRINTH_API_URL=http://127.0.0.1:8000/v2/
 MODRINTH_API_URL_V3=http://127.0.0.1:8000/v3/
 MODRINTH_SOCKET_URL=ws://127.0.0.1:8000/
diff --git a/packages/app-lib/.env.prod b/packages/app-lib/.env.prod
index 94f2c2d34e..8459f8a616 100644
--- a/packages/app-lib/.env.prod
+++ b/packages/app-lib/.env.prod
@@ -1,5 +1,6 @@
 MODRINTH_URL=https://modrinth.com/
 MODRINTH_API_BASE_URL=https://api.modrinth.com/
+SHARED_INSTANCES_API_BASE_URL=https://shared-instances.modrinth.com/
 MODRINTH_ARCHON_BASE_URL=https://archon.modrinth.com/
 MODRINTH_API_URL=https://api.modrinth.com/v2/
 MODRINTH_API_URL_V3=https://api.modrinth.com/v3/
diff --git a/packages/app-lib/.env.prod-with-staging-archon b/packages/app-lib/.env.prod-with-staging-archon
index b2d549c0e1..d27b543383 100644
--- a/packages/app-lib/.env.prod-with-staging-archon
+++ b/packages/app-lib/.env.prod-with-staging-archon
@@ -1,5 +1,6 @@
 MODRINTH_URL=https://modrinth.com/
 MODRINTH_API_BASE_URL=https://api.modrinth.com/
+SHARED_INSTANCES_API_BASE_URL=https://shared-instances.modrinth.com/
 MODRINTH_ARCHON_BASE_URL=https://staging-archon.modrinth.com/
 MODRINTH_API_URL=https://api.modrinth.com/v2/
 MODRINTH_API_URL_V3=https://api.modrinth.com/v3/
diff --git a/packages/app-lib/.env.staging b/packages/app-lib/.env.staging
index 0094b73e5a..7b6fe6a177 100644
--- a/packages/app-lib/.env.staging
+++ b/packages/app-lib/.env.staging
@@ -1,5 +1,6 @@
 MODRINTH_URL=https://staging.modrinth.com/
 MODRINTH_API_BASE_URL=https://staging-api.modrinth.com/
+SHARED_INSTANCES_API_BASE_URL=https://staging-shared-instances.modrinth.com/
 MODRINTH_ARCHON_BASE_URL=https://staging-archon.modrinth.com/
 MODRINTH_API_URL=https://staging-api.modrinth.com/v2/
 MODRINTH_API_URL_V3=https://staging-api.modrinth.com/v3/
diff --git a/packages/app-lib/.sqlx/query-bcc93c48dd3c9ccbe196cfbe27e36b774d1b506e6cf5f2ab38469e9e3e6c9b6d.json b/packages/app-lib/.sqlx/query-17551becf0807e9d4d6f66c0c7c145317b71c60974846d92a51c86a6d949c1e4.json
similarity index 80%
rename from packages/app-lib/.sqlx/query-bcc93c48dd3c9ccbe196cfbe27e36b774d1b506e6cf5f2ab38469e9e3e6c9b6d.json
rename to packages/app-lib/.sqlx/query-17551becf0807e9d4d6f66c0c7c145317b71c60974846d92a51c86a6d949c1e4.json
index 3b13db9205..892ce008ba 100644
--- a/packages/app-lib/.sqlx/query-bcc93c48dd3c9ccbe196cfbe27e36b774d1b506e6cf5f2ab38469e9e3e6c9b6d.json
+++ b/packages/app-lib/.sqlx/query-17551becf0807e9d4d6f66c0c7c145317b71c60974846d92a51c86a6d949c1e4.json
@@ -1,6 +1,6 @@
 {
   "db_name": "SQLite",
-  "query": "\n        SELECT\n            i.id AS \"id!: String\",\n            i.path AS \"path!: String\",\n            i.applied_content_set_id AS \"applied_content_set_id?: String\",\n            i.install_stage AS \"install_stage!: String\",\n            i.launcher_feature_version AS \"launcher_feature_version!: String\",\n            i.update_channel AS \"update_channel!: String\",\n            i.name AS \"name!: String\",\n            i.icon_path AS \"icon_path?: String\",\n            i.created AS \"created!: i64\",\n            i.modified AS \"modified!: i64\",\n            i.last_played AS \"last_played?: i64\",\n            i.submitted_time_played AS \"submitted_time_played!: i64\",\n            i.recent_time_played AS \"recent_time_played!: i64\",\n            cs.id AS \"content_set_id?: String\",\n            cs.instance_id AS \"content_set_instance_id?: String\",\n            cs.name AS \"content_set_name?: String\",\n            cs.source_kind AS \"content_set_source_kind?: String\",\n            cs.status AS \"content_set_status?: String\",\n            cs.game_version AS \"content_set_game_version?: String\",\n            cs.protocol_version AS \"content_set_protocol_version?: i64\",\n            cs.loader AS \"content_set_loader?: String\",\n            cs.loader_version AS \"content_set_loader_version?: String\",\n            cs.created AS \"content_set_created?: i64\",\n            cs.modified AS \"content_set_modified?: i64\",\n            COALESCE(link.link_kind, 'unmanaged') AS \"link_kind!: String\",\n            link.modrinth_project_id AS \"modrinth_project_id?: String\",\n            link.modrinth_version_id AS \"modrinth_version_id?: String\",\n            link.server_project_id AS \"server_project_id?: String\",\n            link.content_project_id AS \"content_project_id?: String\",\n            link.content_version_id AS \"content_version_id?: String\",\n            link.hosting_server_id AS \"hosting_server_id?: String\",\n            json(link.hosting_instance_ids) AS \"hosting_instance_ids?: String\",\n            link.hosting_active_instance_id AS \"hosting_active_instance_id?: String\",\n            link.shared_instance_id AS \"shared_instance_id?: String\",\n            link.imported_name AS \"imported_name?: String\",\n            link.imported_version_number AS \"imported_version_number?: String\",\n            link.imported_filename AS \"imported_filename?: String\",\n            COALESCE((\n                SELECT json_group_array(group_name)\n                FROM (\n                    SELECT group_name\n                    FROM instance_groups\n                    WHERE instance_id = i.id\n                    ORDER BY group_name\n                )\n            ), '[]') AS \"groups!: String\",\n            json(overrides.overrides) AS \"launch_overrides?: String\"\n        FROM instances i\n        LEFT JOIN instance_content_sets cs\n            ON cs.id = i.applied_content_set_id\n            AND cs.instance_id = i.id\n        LEFT JOIN instance_links link\n            ON link.instance_id = i.id\n        LEFT JOIN instance_launch_overrides overrides\n            ON overrides.instance_id = i.id\n        WHERE i.id = ?\n        ",
+  "query": "\n        SELECT\n            i.id AS \"id!: String\",\n            i.path AS \"path!: String\",\n            i.applied_content_set_id AS \"applied_content_set_id?: String\",\n            i.install_stage AS \"install_stage!: String\",\n            i.launcher_feature_version AS \"launcher_feature_version!: String\",\n            i.update_channel AS \"update_channel!: String\",\n            i.name AS \"name!: String\",\n            i.icon_path AS \"icon_path?: String\",\n            i.created AS \"created!: i64\",\n            i.modified AS \"modified!: i64\",\n            i.last_played AS \"last_played?: i64\",\n            i.submitted_time_played AS \"submitted_time_played!: i64\",\n            i.recent_time_played AS \"recent_time_played!: i64\",\n            cs.id AS \"content_set_id?: String\",\n            cs.instance_id AS \"content_set_instance_id?: String\",\n            cs.name AS \"content_set_name?: String\",\n            cs.source_kind AS \"content_set_source_kind?: String\",\n            cs.status AS \"content_set_status?: String\",\n            cs.game_version AS \"content_set_game_version?: String\",\n            cs.protocol_version AS \"content_set_protocol_version?: i64\",\n            cs.loader AS \"content_set_loader?: String\",\n            cs.loader_version AS \"content_set_loader_version?: String\",\n            cs.created AS \"content_set_created?: i64\",\n            cs.modified AS \"content_set_modified?: i64\",\n            COALESCE(link.link_kind, 'unmanaged') AS \"link_kind!: String\",\n            link.modrinth_project_id AS \"modrinth_project_id?: String\",\n            link.modrinth_version_id AS \"modrinth_version_id?: String\",\n            link.server_project_id AS \"server_project_id?: String\",\n            link.content_project_id AS \"content_project_id?: String\",\n            link.content_version_id AS \"content_version_id?: String\",\n            link.hosting_server_id AS \"hosting_server_id?: String\",\n            json(link.hosting_instance_ids) AS \"hosting_instance_ids?: String\",\n            link.hosting_active_instance_id AS \"hosting_active_instance_id?: String\",\n            link.shared_instance_id AS \"shared_instance_id?: String\",\n            link.shared_instance_role AS \"shared_instance_role?: String\",\n            sync.applied_update_id AS \"shared_sync_applied_update_id?: String\",\n            sync.latest_available_update_id AS \"shared_sync_latest_available_update_id?: String\",\n            sync.status AS \"shared_sync_status?: String\",\n            link.imported_name AS \"imported_name?: String\",\n            link.imported_version_number AS \"imported_version_number?: String\",\n            link.imported_filename AS \"imported_filename?: String\",\n            '[]' AS \"groups!: String\",\n            json(overrides.overrides) AS \"launch_overrides?: String\"\n        FROM instances i\n        LEFT JOIN instance_content_sets cs\n            ON cs.id = i.applied_content_set_id\n            AND cs.instance_id = i.id\n        LEFT JOIN instance_links link\n            ON link.instance_id = i.id\n        LEFT JOIN instance_content_set_sync_state sync\n            ON sync.content_set_id = cs.id\n            AND sync.provider = 'shared_instance'\n        LEFT JOIN instance_launch_overrides overrides\n            ON overrides.instance_id = i.id\n        WHERE i.id = ?\n        ",
   "describe": {
     "columns": [
       {
@@ -174,28 +174,48 @@
         "type_info": "Text"
       },
       {
-        "name": "imported_name?: String",
+        "name": "shared_instance_role?: String",
         "ordinal": 34,
         "type_info": "Text"
       },
       {
-        "name": "imported_version_number?: String",
+        "name": "shared_sync_applied_update_id?: String",
         "ordinal": 35,
         "type_info": "Text"
       },
       {
-        "name": "imported_filename?: String",
+        "name": "shared_sync_latest_available_update_id?: String",
         "ordinal": 36,
         "type_info": "Text"
       },
       {
-        "name": "groups!: String",
+        "name": "shared_sync_status?: String",
         "ordinal": 37,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_name?: String",
+        "ordinal": 38,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_version_number?: String",
+        "ordinal": 39,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_filename?: String",
+        "ordinal": 40,
+        "type_info": "Text"
+      },
+      {
+        "name": "groups!: String",
+        "ordinal": 41,
         "type_info": "Null"
       },
       {
         "name": "launch_overrides?: String",
-        "ordinal": 38,
+        "ordinal": 42,
         "type_info": "Null"
       }
     ],
@@ -240,9 +260,13 @@
       true,
       true,
       true,
+      false,
+      true,
+      true,
+      true,
       null,
       null
     ]
   },
-  "hash": "bcc93c48dd3c9ccbe196cfbe27e36b774d1b506e6cf5f2ab38469e9e3e6c9b6d"
+  "hash": "17551becf0807e9d4d6f66c0c7c145317b71c60974846d92a51c86a6d949c1e4"
 }
diff --git a/packages/app-lib/.sqlx/query-2bf4029dd68e983460b8a0b06e1209885ef8e87ad2a8666a9cf1c851a2948cbc.json b/packages/app-lib/.sqlx/query-2bf4029dd68e983460b8a0b06e1209885ef8e87ad2a8666a9cf1c851a2948cbc.json
new file mode 100644
index 0000000000..76d7ed3fc8
--- /dev/null
+++ b/packages/app-lib/.sqlx/query-2bf4029dd68e983460b8a0b06e1209885ef8e87ad2a8666a9cf1c851a2948cbc.json
@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "\n\t\tINSERT INTO instance_content_set_remote_refs (\n\t\t\tcontent_set_id,\n\t\t\tref_type,\n\t\t\tref_id\n\t\t)\n\t\tVALUES (?, ?, ?)\n\t\tON CONFLICT (content_set_id, ref_type) DO UPDATE SET\n\t\t\tref_id = excluded.ref_id\n\t\t",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": []
+  },
+  "hash": "2bf4029dd68e983460b8a0b06e1209885ef8e87ad2a8666a9cf1c851a2948cbc"
+}
diff --git a/packages/app-lib/.sqlx/query-474496fe9b4f0ae920ceef97176dac61544130300cdf2cfc8deb7fbf2efaf8c7.json b/packages/app-lib/.sqlx/query-3a54fa17925209615ace1bc85c247c9befab9ad765389929cd37b4c2f603ef79.json
similarity index 77%
rename from packages/app-lib/.sqlx/query-474496fe9b4f0ae920ceef97176dac61544130300cdf2cfc8deb7fbf2efaf8c7.json
rename to packages/app-lib/.sqlx/query-3a54fa17925209615ace1bc85c247c9befab9ad765389929cd37b4c2f603ef79.json
index 14967a6a1c..8939d40051 100644
--- a/packages/app-lib/.sqlx/query-474496fe9b4f0ae920ceef97176dac61544130300cdf2cfc8deb7fbf2efaf8c7.json
+++ b/packages/app-lib/.sqlx/query-3a54fa17925209615ace1bc85c247c9befab9ad765389929cd37b4c2f603ef79.json
@@ -1,6 +1,6 @@
 {
   "db_name": "SQLite",
-  "query": "\n        SELECT\n            i.id AS \"id!: String\",\n            i.path AS \"path!: String\",\n            i.applied_content_set_id AS \"applied_content_set_id?: String\",\n            i.install_stage AS \"install_stage!: String\",\n            i.launcher_feature_version AS \"launcher_feature_version!: String\",\n            i.update_channel AS \"update_channel!: String\",\n            i.name AS \"name!: String\",\n            i.icon_path AS \"icon_path?: String\",\n            i.created AS \"created!: i64\",\n            i.modified AS \"modified!: i64\",\n            i.last_played AS \"last_played?: i64\",\n            i.submitted_time_played AS \"submitted_time_played!: i64\",\n            i.recent_time_played AS \"recent_time_played!: i64\",\n            cs.id AS \"content_set_id?: String\",\n            cs.instance_id AS \"content_set_instance_id?: String\",\n            cs.name AS \"content_set_name?: String\",\n            cs.source_kind AS \"content_set_source_kind?: String\",\n            cs.status AS \"content_set_status?: String\",\n            cs.game_version AS \"content_set_game_version?: String\",\n            cs.protocol_version AS \"content_set_protocol_version?: i64\",\n            cs.loader AS \"content_set_loader?: String\",\n            cs.loader_version AS \"content_set_loader_version?: String\",\n            cs.created AS \"content_set_created?: i64\",\n            cs.modified AS \"content_set_modified?: i64\",\n            COALESCE(link.link_kind, 'unmanaged') AS \"link_kind!: String\",\n            link.modrinth_project_id AS \"modrinth_project_id?: String\",\n            link.modrinth_version_id AS \"modrinth_version_id?: String\",\n            link.server_project_id AS \"server_project_id?: String\",\n            link.content_project_id AS \"content_project_id?: String\",\n            link.content_version_id AS \"content_version_id?: String\",\n            link.hosting_server_id AS \"hosting_server_id?: String\",\n            json(link.hosting_instance_ids) AS \"hosting_instance_ids?: String\",\n            link.hosting_active_instance_id AS \"hosting_active_instance_id?: String\",\n            link.shared_instance_id AS \"shared_instance_id?: String\",\n            link.imported_name AS \"imported_name?: String\",\n            link.imported_version_number AS \"imported_version_number?: String\",\n            link.imported_filename AS \"imported_filename?: String\",\n            '[]' AS \"groups!: String\",\n            json(overrides.overrides) AS \"launch_overrides?: String\"\n        FROM instances i\n        LEFT JOIN instance_content_sets cs\n            ON cs.id = i.applied_content_set_id\n            AND cs.instance_id = i.id\n        LEFT JOIN instance_links link\n            ON link.instance_id = i.id\n        LEFT JOIN instance_launch_overrides overrides\n            ON overrides.instance_id = i.id\n        WHERE i.id = ?\n        ",
+  "query": "\n        SELECT\n            i.id AS \"id!: String\",\n            i.path AS \"path!: String\",\n            i.applied_content_set_id AS \"applied_content_set_id?: String\",\n            i.install_stage AS \"install_stage!: String\",\n            i.launcher_feature_version AS \"launcher_feature_version!: String\",\n            i.update_channel AS \"update_channel!: String\",\n            i.name AS \"name!: String\",\n            i.icon_path AS \"icon_path?: String\",\n            i.created AS \"created!: i64\",\n            i.modified AS \"modified!: i64\",\n            i.last_played AS \"last_played?: i64\",\n            i.submitted_time_played AS \"submitted_time_played!: i64\",\n            i.recent_time_played AS \"recent_time_played!: i64\",\n            cs.id AS \"content_set_id?: String\",\n            cs.instance_id AS \"content_set_instance_id?: String\",\n            cs.name AS \"content_set_name?: String\",\n            cs.source_kind AS \"content_set_source_kind?: String\",\n            cs.status AS \"content_set_status?: String\",\n            cs.game_version AS \"content_set_game_version?: String\",\n            cs.protocol_version AS \"content_set_protocol_version?: i64\",\n            cs.loader AS \"content_set_loader?: String\",\n            cs.loader_version AS \"content_set_loader_version?: String\",\n            cs.created AS \"content_set_created?: i64\",\n            cs.modified AS \"content_set_modified?: i64\",\n            COALESCE(link.link_kind, 'unmanaged') AS \"link_kind!: String\",\n            link.modrinth_project_id AS \"modrinth_project_id?: String\",\n            link.modrinth_version_id AS \"modrinth_version_id?: String\",\n            link.server_project_id AS \"server_project_id?: String\",\n            link.content_project_id AS \"content_project_id?: String\",\n            link.content_version_id AS \"content_version_id?: String\",\n            link.hosting_server_id AS \"hosting_server_id?: String\",\n            json(link.hosting_instance_ids) AS \"hosting_instance_ids?: String\",\n            link.hosting_active_instance_id AS \"hosting_active_instance_id?: String\",\n            link.shared_instance_id AS \"shared_instance_id?: String\",\n            link.shared_instance_role AS \"shared_instance_role?: String\",\n            sync.applied_update_id AS \"shared_sync_applied_update_id?: String\",\n            sync.latest_available_update_id AS \"shared_sync_latest_available_update_id?: String\",\n            sync.status AS \"shared_sync_status?: String\",\n            link.imported_name AS \"imported_name?: String\",\n            link.imported_version_number AS \"imported_version_number?: String\",\n            link.imported_filename AS \"imported_filename?: String\",\n            COALESCE((\n                SELECT json_group_array(group_name)\n                FROM (\n                    SELECT group_name\n                    FROM instance_groups\n                    WHERE instance_id = i.id\n                    ORDER BY group_name\n                )\n            ), '[]') AS \"groups!: String\",\n            json(overrides.overrides) AS \"launch_overrides?: String\"\n        FROM instances i\n        LEFT JOIN instance_content_sets cs\n            ON cs.id = i.applied_content_set_id\n            AND cs.instance_id = i.id\n        LEFT JOIN instance_links link\n            ON link.instance_id = i.id\n        LEFT JOIN instance_content_set_sync_state sync\n            ON sync.content_set_id = cs.id\n            AND sync.provider = 'shared_instance'\n        LEFT JOIN instance_launch_overrides overrides\n            ON overrides.instance_id = i.id\n        WHERE i.id = ?\n        ",
   "describe": {
     "columns": [
       {
@@ -174,28 +174,48 @@
         "type_info": "Text"
       },
       {
-        "name": "imported_name?: String",
+        "name": "shared_instance_role?: String",
         "ordinal": 34,
         "type_info": "Text"
       },
       {
-        "name": "imported_version_number?: String",
+        "name": "shared_sync_applied_update_id?: String",
         "ordinal": 35,
         "type_info": "Text"
       },
       {
-        "name": "imported_filename?: String",
+        "name": "shared_sync_latest_available_update_id?: String",
         "ordinal": 36,
         "type_info": "Text"
       },
       {
-        "name": "groups!: String",
+        "name": "shared_sync_status?: String",
         "ordinal": 37,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_name?: String",
+        "ordinal": 38,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_version_number?: String",
+        "ordinal": 39,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_filename?: String",
+        "ordinal": 40,
+        "type_info": "Text"
+      },
+      {
+        "name": "groups!: String",
+        "ordinal": 41,
         "type_info": "Null"
       },
       {
         "name": "launch_overrides?: String",
-        "ordinal": 38,
+        "ordinal": 42,
         "type_info": "Null"
       }
     ],
@@ -240,9 +260,13 @@
       true,
       true,
       true,
+      false,
+      true,
+      true,
+      true,
       null,
       null
     ]
   },
-  "hash": "474496fe9b4f0ae920ceef97176dac61544130300cdf2cfc8deb7fbf2efaf8c7"
+  "hash": "3a54fa17925209615ace1bc85c247c9befab9ad765389929cd37b4c2f603ef79"
 }
diff --git a/packages/app-lib/.sqlx/query-6231cfa8f3b21c0fd502e16f823881fd9c44bccaedb9b06585ff8f76146c6e57.json b/packages/app-lib/.sqlx/query-6231cfa8f3b21c0fd502e16f823881fd9c44bccaedb9b06585ff8f76146c6e57.json
new file mode 100644
index 0000000000..ad566bf3da
--- /dev/null
+++ b/packages/app-lib/.sqlx/query-6231cfa8f3b21c0fd502e16f823881fd9c44bccaedb9b06585ff8f76146c6e57.json
@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "\n\t\tINSERT INTO instance_content_set_sync_state (\n\t\t\tcontent_set_id,\n\t\t\tprovider,\n\t\t\tapplied_update_id,\n\t\t\tlatest_available_update_id,\n\t\t\tchecked_at,\n\t\t\tstatus\n\t\t)\n\t\tVALUES (?, ?, ?, ?, ?, ?)\n\t\tON CONFLICT (content_set_id) DO UPDATE SET\n\t\t\tprovider = excluded.provider,\n\t\t\tapplied_update_id = excluded.applied_update_id,\n\t\t\tlatest_available_update_id = excluded.latest_available_update_id,\n\t\t\tchecked_at = excluded.checked_at,\n\t\t\tstatus = excluded.status\n\t\t",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 6
+    },
+    "nullable": []
+  },
+  "hash": "6231cfa8f3b21c0fd502e16f823881fd9c44bccaedb9b06585ff8f76146c6e57"
+}
diff --git a/packages/app-lib/.sqlx/query-76988815779ec3c1def6712dcb4156fd72100b0cf97b4ecb11045c6c4f550652.json b/packages/app-lib/.sqlx/query-76988815779ec3c1def6712dcb4156fd72100b0cf97b4ecb11045c6c4f550652.json
new file mode 100644
index 0000000000..b829fe372e
--- /dev/null
+++ b/packages/app-lib/.sqlx/query-76988815779ec3c1def6712dcb4156fd72100b0cf97b4ecb11045c6c4f550652.json
@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "\n\t\tDELETE FROM instance_content_set_remote_refs\n\t\tWHERE content_set_id = ? AND ref_type = ?\n\t\t",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 2
+    },
+    "nullable": []
+  },
+  "hash": "76988815779ec3c1def6712dcb4156fd72100b0cf97b4ecb11045c6c4f550652"
+}
diff --git a/packages/app-lib/.sqlx/query-91f896fca714a103f20e5538430dc43e23c23713352425d23da91ca524ec2661.json b/packages/app-lib/.sqlx/query-91f896fca714a103f20e5538430dc43e23c23713352425d23da91ca524ec2661.json
new file mode 100644
index 0000000000..4d8f6d2f60
--- /dev/null
+++ b/packages/app-lib/.sqlx/query-91f896fca714a103f20e5538430dc43e23c23713352425d23da91ca524ec2661.json
@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "\n\t\tINSERT INTO instance_links (\n\t\t\tinstance_id,\n\t\t\tlink_kind,\n\t\t\tshared_instance_id,\n\t\t\tshared_instance_role\n\t\t)\n\t\tVALUES (?, 'unmanaged', ?, ?)\n\t\tON CONFLICT (instance_id) DO UPDATE SET\n\t\t\tlink_kind = CASE\n\t\t\t\tWHEN excluded.shared_instance_id IS NULL\n\t\t\t\t\tAND instance_links.link_kind = 'shared_instance'\n\t\t\t\t\tTHEN 'unmanaged'\n\t\t\t\tELSE instance_links.link_kind\n\t\t\tEND,\n\t\t\tshared_instance_id = excluded.shared_instance_id,\n\t\t\tshared_instance_role = excluded.shared_instance_role\n\t\t",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": []
+  },
+  "hash": "91f896fca714a103f20e5538430dc43e23c23713352425d23da91ca524ec2661"
+}
diff --git a/packages/app-lib/.sqlx/query-e53cd252e1e9eebcb3fb9714d7b5ee588e751fdc3f18c48bc4cfd94504c37306.json b/packages/app-lib/.sqlx/query-92529a787904da7d3bbfea9ba1c28a50c200591f91019bd0efc7dfe531797d0d.json
similarity index 76%
rename from packages/app-lib/.sqlx/query-e53cd252e1e9eebcb3fb9714d7b5ee588e751fdc3f18c48bc4cfd94504c37306.json
rename to packages/app-lib/.sqlx/query-92529a787904da7d3bbfea9ba1c28a50c200591f91019bd0efc7dfe531797d0d.json
index def78302d6..b61f2b6597 100644
--- a/packages/app-lib/.sqlx/query-e53cd252e1e9eebcb3fb9714d7b5ee588e751fdc3f18c48bc4cfd94504c37306.json
+++ b/packages/app-lib/.sqlx/query-92529a787904da7d3bbfea9ba1c28a50c200591f91019bd0efc7dfe531797d0d.json
@@ -1,6 +1,6 @@
 {
   "db_name": "SQLite",
-  "query": "\n        WITH requested AS (\n            SELECT value AS id, key AS ord\n            FROM json_each(?)\n        )\n        SELECT\n            i.id AS \"id!: String\",\n            i.path AS \"path!: String\",\n            i.applied_content_set_id AS \"applied_content_set_id?: String\",\n            i.install_stage AS \"install_stage!: String\",\n            i.launcher_feature_version AS \"launcher_feature_version!: String\",\n            i.update_channel AS \"update_channel!: String\",\n            i.name AS \"name!: String\",\n            i.icon_path AS \"icon_path?: String\",\n            i.created AS \"created!: i64\",\n            i.modified AS \"modified!: i64\",\n            i.last_played AS \"last_played?: i64\",\n            i.submitted_time_played AS \"submitted_time_played!: i64\",\n            i.recent_time_played AS \"recent_time_played!: i64\",\n            cs.id AS \"content_set_id?: String\",\n            cs.instance_id AS \"content_set_instance_id?: String\",\n            cs.name AS \"content_set_name?: String\",\n            cs.source_kind AS \"content_set_source_kind?: String\",\n            cs.status AS \"content_set_status?: String\",\n            cs.game_version AS \"content_set_game_version?: String\",\n            cs.protocol_version AS \"content_set_protocol_version?: i64\",\n            cs.loader AS \"content_set_loader?: String\",\n            cs.loader_version AS \"content_set_loader_version?: String\",\n            cs.created AS \"content_set_created?: i64\",\n            cs.modified AS \"content_set_modified?: i64\",\n            COALESCE(link.link_kind, 'unmanaged') AS \"link_kind!: String\",\n            link.modrinth_project_id AS \"modrinth_project_id?: String\",\n            link.modrinth_version_id AS \"modrinth_version_id?: String\",\n            link.server_project_id AS \"server_project_id?: String\",\n            link.content_project_id AS \"content_project_id?: String\",\n            link.content_version_id AS \"content_version_id?: String\",\n            link.hosting_server_id AS \"hosting_server_id?: String\",\n            json(link.hosting_instance_ids) AS \"hosting_instance_ids?: String\",\n            link.hosting_active_instance_id AS \"hosting_active_instance_id?: String\",\n            link.shared_instance_id AS \"shared_instance_id?: String\",\n            link.imported_name AS \"imported_name?: String\",\n            link.imported_version_number AS \"imported_version_number?: String\",\n            link.imported_filename AS \"imported_filename?: String\",\n            COALESCE((\n                SELECT json_group_array(group_name)\n                FROM (\n                    SELECT group_name\n                    FROM instance_groups\n                    WHERE instance_id = i.id\n                    ORDER BY group_name\n                )\n            ), '[]') AS \"groups!: String\",\n            json(overrides.overrides) AS \"launch_overrides?: String\"\n        FROM requested\n        INNER JOIN instances i\n            ON i.id = requested.id\n        LEFT JOIN instance_content_sets cs\n            ON cs.id = i.applied_content_set_id\n            AND cs.instance_id = i.id\n        LEFT JOIN instance_links link\n            ON link.instance_id = i.id\n        LEFT JOIN instance_launch_overrides overrides\n            ON overrides.instance_id = i.id\n        ORDER BY requested.ord\n        ",
+  "query": "\n        WITH requested AS (\n            SELECT value AS id, key AS ord\n            FROM json_each(?)\n        )\n        SELECT\n            i.id AS \"id!: String\",\n            i.path AS \"path!: String\",\n            i.applied_content_set_id AS \"applied_content_set_id?: String\",\n            i.install_stage AS \"install_stage!: String\",\n            i.launcher_feature_version AS \"launcher_feature_version!: String\",\n            i.update_channel AS \"update_channel!: String\",\n            i.name AS \"name!: String\",\n            i.icon_path AS \"icon_path?: String\",\n            i.created AS \"created!: i64\",\n            i.modified AS \"modified!: i64\",\n            i.last_played AS \"last_played?: i64\",\n            i.submitted_time_played AS \"submitted_time_played!: i64\",\n            i.recent_time_played AS \"recent_time_played!: i64\",\n            cs.id AS \"content_set_id?: String\",\n            cs.instance_id AS \"content_set_instance_id?: String\",\n            cs.name AS \"content_set_name?: String\",\n            cs.source_kind AS \"content_set_source_kind?: String\",\n            cs.status AS \"content_set_status?: String\",\n            cs.game_version AS \"content_set_game_version?: String\",\n            cs.protocol_version AS \"content_set_protocol_version?: i64\",\n            cs.loader AS \"content_set_loader?: String\",\n            cs.loader_version AS \"content_set_loader_version?: String\",\n            cs.created AS \"content_set_created?: i64\",\n            cs.modified AS \"content_set_modified?: i64\",\n            COALESCE(link.link_kind, 'unmanaged') AS \"link_kind!: String\",\n            link.modrinth_project_id AS \"modrinth_project_id?: String\",\n            link.modrinth_version_id AS \"modrinth_version_id?: String\",\n            link.server_project_id AS \"server_project_id?: String\",\n            link.content_project_id AS \"content_project_id?: String\",\n            link.content_version_id AS \"content_version_id?: String\",\n            link.hosting_server_id AS \"hosting_server_id?: String\",\n            json(link.hosting_instance_ids) AS \"hosting_instance_ids?: String\",\n            link.hosting_active_instance_id AS \"hosting_active_instance_id?: String\",\n            link.shared_instance_id AS \"shared_instance_id?: String\",\n            link.shared_instance_role AS \"shared_instance_role?: String\",\n            sync.applied_update_id AS \"shared_sync_applied_update_id?: String\",\n            sync.latest_available_update_id AS \"shared_sync_latest_available_update_id?: String\",\n            sync.status AS \"shared_sync_status?: String\",\n            link.imported_name AS \"imported_name?: String\",\n            link.imported_version_number AS \"imported_version_number?: String\",\n            link.imported_filename AS \"imported_filename?: String\",\n            COALESCE((\n                SELECT json_group_array(group_name)\n                FROM (\n                    SELECT group_name\n                    FROM instance_groups\n                    WHERE instance_id = i.id\n                    ORDER BY group_name\n                )\n            ), '[]') AS \"groups!: String\",\n            json(overrides.overrides) AS \"launch_overrides?: String\"\n        FROM requested\n        INNER JOIN instances i\n            ON i.id = requested.id\n        LEFT JOIN instance_content_sets cs\n            ON cs.id = i.applied_content_set_id\n            AND cs.instance_id = i.id\n        LEFT JOIN instance_links link\n            ON link.instance_id = i.id\n        LEFT JOIN instance_content_set_sync_state sync\n            ON sync.content_set_id = cs.id\n            AND sync.provider = 'shared_instance'\n        LEFT JOIN instance_launch_overrides overrides\n            ON overrides.instance_id = i.id\n        ORDER BY requested.ord\n        ",
   "describe": {
     "columns": [
       {
@@ -174,28 +174,48 @@
         "type_info": "Text"
       },
       {
-        "name": "imported_name?: String",
+        "name": "shared_instance_role?: String",
         "ordinal": 34,
         "type_info": "Text"
       },
       {
-        "name": "imported_version_number?: String",
+        "name": "shared_sync_applied_update_id?: String",
         "ordinal": 35,
         "type_info": "Text"
       },
       {
-        "name": "imported_filename?: String",
+        "name": "shared_sync_latest_available_update_id?: String",
         "ordinal": 36,
         "type_info": "Text"
       },
       {
-        "name": "groups!: String",
+        "name": "shared_sync_status?: String",
         "ordinal": 37,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_name?: String",
+        "ordinal": 38,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_version_number?: String",
+        "ordinal": 39,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_filename?: String",
+        "ordinal": 40,
+        "type_info": "Text"
+      },
+      {
+        "name": "groups!: String",
+        "ordinal": 41,
         "type_info": "Null"
       },
       {
         "name": "launch_overrides?: String",
-        "ordinal": 38,
+        "ordinal": 42,
         "type_info": "Null"
       }
     ],
@@ -240,9 +260,13 @@
       true,
       true,
       true,
+      false,
+      true,
+      true,
+      true,
       null,
       null
     ]
   },
-  "hash": "e53cd252e1e9eebcb3fb9714d7b5ee588e751fdc3f18c48bc4cfd94504c37306"
+  "hash": "92529a787904da7d3bbfea9ba1c28a50c200591f91019bd0efc7dfe531797d0d"
 }
diff --git a/packages/app-lib/.sqlx/query-f0d8d4f98f7fdf3d656a7811f232d429a2cc73bc2c752594fcad7da19967ff7b.json b/packages/app-lib/.sqlx/query-a201dd69e61a23240746feca75480c013f6f6766bdeb3578c4a617b2026ac802.json
similarity index 78%
rename from packages/app-lib/.sqlx/query-f0d8d4f98f7fdf3d656a7811f232d429a2cc73bc2c752594fcad7da19967ff7b.json
rename to packages/app-lib/.sqlx/query-a201dd69e61a23240746feca75480c013f6f6766bdeb3578c4a617b2026ac802.json
index 4fcd167707..777197a75e 100644
--- a/packages/app-lib/.sqlx/query-f0d8d4f98f7fdf3d656a7811f232d429a2cc73bc2c752594fcad7da19967ff7b.json
+++ b/packages/app-lib/.sqlx/query-a201dd69e61a23240746feca75480c013f6f6766bdeb3578c4a617b2026ac802.json
@@ -1,6 +1,6 @@
 {
   "db_name": "SQLite",
-  "query": "\n        SELECT\n            i.id AS \"id!: String\",\n            i.path AS \"path!: String\",\n            i.applied_content_set_id AS \"applied_content_set_id?: String\",\n            i.install_stage AS \"install_stage!: String\",\n            i.launcher_feature_version AS \"launcher_feature_version!: String\",\n            i.update_channel AS \"update_channel!: String\",\n            i.name AS \"name!: String\",\n            i.icon_path AS \"icon_path?: String\",\n            i.created AS \"created!: i64\",\n            i.modified AS \"modified!: i64\",\n            i.last_played AS \"last_played?: i64\",\n            i.submitted_time_played AS \"submitted_time_played!: i64\",\n            i.recent_time_played AS \"recent_time_played!: i64\",\n            cs.id AS \"content_set_id?: String\",\n            cs.instance_id AS \"content_set_instance_id?: String\",\n            cs.name AS \"content_set_name?: String\",\n            cs.source_kind AS \"content_set_source_kind?: String\",\n            cs.status AS \"content_set_status?: String\",\n            cs.game_version AS \"content_set_game_version?: String\",\n            cs.protocol_version AS \"content_set_protocol_version?: i64\",\n            cs.loader AS \"content_set_loader?: String\",\n            cs.loader_version AS \"content_set_loader_version?: String\",\n            cs.created AS \"content_set_created?: i64\",\n            cs.modified AS \"content_set_modified?: i64\",\n            COALESCE(link.link_kind, 'unmanaged') AS \"link_kind!: String\",\n            link.modrinth_project_id AS \"modrinth_project_id?: String\",\n            link.modrinth_version_id AS \"modrinth_version_id?: String\",\n            link.server_project_id AS \"server_project_id?: String\",\n            link.content_project_id AS \"content_project_id?: String\",\n            link.content_version_id AS \"content_version_id?: String\",\n            link.hosting_server_id AS \"hosting_server_id?: String\",\n            json(link.hosting_instance_ids) AS \"hosting_instance_ids?: String\",\n            link.hosting_active_instance_id AS \"hosting_active_instance_id?: String\",\n            link.shared_instance_id AS \"shared_instance_id?: String\",\n            link.imported_name AS \"imported_name?: String\",\n            link.imported_version_number AS \"imported_version_number?: String\",\n            link.imported_filename AS \"imported_filename?: String\",\n            COALESCE((\n                SELECT json_group_array(group_name)\n                FROM (\n                    SELECT group_name\n                    FROM instance_groups\n                    WHERE instance_id = i.id\n                    ORDER BY group_name\n                )\n            ), '[]') AS \"groups!: String\",\n            json(overrides.overrides) AS \"launch_overrides?: String\"\n        FROM instances i\n        LEFT JOIN instance_content_sets cs\n            ON cs.id = i.applied_content_set_id\n            AND cs.instance_id = i.id\n        LEFT JOIN instance_links link\n            ON link.instance_id = i.id\n        LEFT JOIN instance_launch_overrides overrides\n            ON overrides.instance_id = i.id\n        ",
+  "query": "\n        SELECT\n            i.id AS \"id!: String\",\n            i.path AS \"path!: String\",\n            i.applied_content_set_id AS \"applied_content_set_id?: String\",\n            i.install_stage AS \"install_stage!: String\",\n            i.launcher_feature_version AS \"launcher_feature_version!: String\",\n            i.update_channel AS \"update_channel!: String\",\n            i.name AS \"name!: String\",\n            i.icon_path AS \"icon_path?: String\",\n            i.created AS \"created!: i64\",\n            i.modified AS \"modified!: i64\",\n            i.last_played AS \"last_played?: i64\",\n            i.submitted_time_played AS \"submitted_time_played!: i64\",\n            i.recent_time_played AS \"recent_time_played!: i64\",\n            cs.id AS \"content_set_id?: String\",\n            cs.instance_id AS \"content_set_instance_id?: String\",\n            cs.name AS \"content_set_name?: String\",\n            cs.source_kind AS \"content_set_source_kind?: String\",\n            cs.status AS \"content_set_status?: String\",\n            cs.game_version AS \"content_set_game_version?: String\",\n            cs.protocol_version AS \"content_set_protocol_version?: i64\",\n            cs.loader AS \"content_set_loader?: String\",\n            cs.loader_version AS \"content_set_loader_version?: String\",\n            cs.created AS \"content_set_created?: i64\",\n            cs.modified AS \"content_set_modified?: i64\",\n            COALESCE(link.link_kind, 'unmanaged') AS \"link_kind!: String\",\n            link.modrinth_project_id AS \"modrinth_project_id?: String\",\n            link.modrinth_version_id AS \"modrinth_version_id?: String\",\n            link.server_project_id AS \"server_project_id?: String\",\n            link.content_project_id AS \"content_project_id?: String\",\n            link.content_version_id AS \"content_version_id?: String\",\n            link.hosting_server_id AS \"hosting_server_id?: String\",\n            json(link.hosting_instance_ids) AS \"hosting_instance_ids?: String\",\n            link.hosting_active_instance_id AS \"hosting_active_instance_id?: String\",\n            link.shared_instance_id AS \"shared_instance_id?: String\",\n            link.shared_instance_role AS \"shared_instance_role?: String\",\n            sync.applied_update_id AS \"shared_sync_applied_update_id?: String\",\n            sync.latest_available_update_id AS \"shared_sync_latest_available_update_id?: String\",\n            sync.status AS \"shared_sync_status?: String\",\n            link.imported_name AS \"imported_name?: String\",\n            link.imported_version_number AS \"imported_version_number?: String\",\n            link.imported_filename AS \"imported_filename?: String\",\n            COALESCE((\n                SELECT json_group_array(group_name)\n                FROM (\n                    SELECT group_name\n                    FROM instance_groups\n                    WHERE instance_id = i.id\n                    ORDER BY group_name\n                )\n            ), '[]') AS \"groups!: String\",\n            json(overrides.overrides) AS \"launch_overrides?: String\"\n        FROM instances i\n        LEFT JOIN instance_content_sets cs\n            ON cs.id = i.applied_content_set_id\n            AND cs.instance_id = i.id\n        LEFT JOIN instance_links link\n            ON link.instance_id = i.id\n        LEFT JOIN instance_content_set_sync_state sync\n            ON sync.content_set_id = cs.id\n            AND sync.provider = 'shared_instance'\n        LEFT JOIN instance_launch_overrides overrides\n            ON overrides.instance_id = i.id\n        ",
   "describe": {
     "columns": [
       {
@@ -174,28 +174,48 @@
         "type_info": "Text"
       },
       {
-        "name": "imported_name?: String",
+        "name": "shared_instance_role?: String",
         "ordinal": 34,
         "type_info": "Text"
       },
       {
-        "name": "imported_version_number?: String",
+        "name": "shared_sync_applied_update_id?: String",
         "ordinal": 35,
         "type_info": "Text"
       },
       {
-        "name": "imported_filename?: String",
+        "name": "shared_sync_latest_available_update_id?: String",
         "ordinal": 36,
         "type_info": "Text"
       },
       {
-        "name": "groups!: String",
+        "name": "shared_sync_status?: String",
         "ordinal": 37,
         "type_info": "Text"
       },
       {
-        "name": "launch_overrides?: String",
+        "name": "imported_name?: String",
         "ordinal": 38,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_version_number?: String",
+        "ordinal": 39,
+        "type_info": "Text"
+      },
+      {
+        "name": "imported_filename?: String",
+        "ordinal": 40,
+        "type_info": "Text"
+      },
+      {
+        "name": "groups!: String",
+        "ordinal": 41,
+        "type_info": "Text"
+      },
+      {
+        "name": "launch_overrides?: String",
+        "ordinal": 42,
         "type_info": "Null"
       }
     ],
@@ -240,9 +260,13 @@
       true,
       true,
       true,
+      true,
+      true,
+      true,
+      true,
       false,
       null
     ]
   },
-  "hash": "f0d8d4f98f7fdf3d656a7811f232d429a2cc73bc2c752594fcad7da19967ff7b"
+  "hash": "a201dd69e61a23240746feca75480c013f6f6766bdeb3578c4a617b2026ac802"
 }
diff --git a/packages/app-lib/.sqlx/query-becbba7c6dfb4b22520cc1887718af544c08d3e274a930a68daf3e94e3612243.json b/packages/app-lib/.sqlx/query-becbba7c6dfb4b22520cc1887718af544c08d3e274a930a68daf3e94e3612243.json
new file mode 100644
index 0000000000..809392531d
--- /dev/null
+++ b/packages/app-lib/.sqlx/query-becbba7c6dfb4b22520cc1887718af544c08d3e274a930a68daf3e94e3612243.json
@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "\n\t\tDELETE FROM instance_content_set_sync_state\n\t\tWHERE content_set_id = ?\n\t\t",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 1
+    },
+    "nullable": []
+  },
+  "hash": "becbba7c6dfb4b22520cc1887718af544c08d3e274a930a68daf3e94e3612243"
+}
diff --git a/packages/app-lib/.sqlx/query-bf813910a5b0db8563a689088eedf95c67b5ceda04aa1b0eb782b581e23ec06b.json b/packages/app-lib/.sqlx/query-bf813910a5b0db8563a689088eedf95c67b5ceda04aa1b0eb782b581e23ec06b.json
new file mode 100644
index 0000000000..c26399515b
--- /dev/null
+++ b/packages/app-lib/.sqlx/query-bf813910a5b0db8563a689088eedf95c67b5ceda04aa1b0eb782b581e23ec06b.json
@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "\n\t\tINSERT INTO instance_links (\n\t\t\tinstance_id,\n\t\t\tlink_kind,\n\t\t\tmodrinth_project_id,\n\t\t\tmodrinth_version_id,\n\t\t\tserver_project_id,\n\t\t\tcontent_project_id,\n\t\t\tcontent_version_id,\n\t\t\thosting_server_id,\n\t\t\thosting_instance_ids,\n\t\t\thosting_active_instance_id,\n\t\t\timported_name,\n\t\t\timported_version_number,\n\t\t\timported_filename\n\t\t)\n\t\tVALUES (?, ?, ?, ?, ?, ?, ?, ?, jsonb(?), ?, ?, ?, ?)\n\t\tON CONFLICT (instance_id) DO UPDATE SET\n\t\t\tlink_kind = excluded.link_kind,\n\t\t\tmodrinth_project_id = excluded.modrinth_project_id,\n\t\t\tmodrinth_version_id = excluded.modrinth_version_id,\n\t\t\tserver_project_id = excluded.server_project_id,\n\t\t\tcontent_project_id = excluded.content_project_id,\n\t\t\tcontent_version_id = excluded.content_version_id,\n\t\t\thosting_server_id = excluded.hosting_server_id,\n\t\t\thosting_instance_ids = excluded.hosting_instance_ids,\n\t\t\thosting_active_instance_id = excluded.hosting_active_instance_id,\n\t\t\timported_name = excluded.imported_name,\n\t\t\timported_version_number = excluded.imported_version_number,\n\t\t\timported_filename = excluded.imported_filename\n\t\t",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 13
+    },
+    "nullable": []
+  },
+  "hash": "bf813910a5b0db8563a689088eedf95c67b5ceda04aa1b0eb782b581e23ec06b"
+}
diff --git a/packages/app-lib/.sqlx/query-26d23094e9d76e5595d5e5a0cd6bc631c45e6090bf40b26e25024de434fe0281.json b/packages/app-lib/.sqlx/query-e5665a8f1f5360cb236199bdc7565775a8a893b9f17401f8d9ec9148725d4940.json
similarity index 82%
rename from packages/app-lib/.sqlx/query-26d23094e9d76e5595d5e5a0cd6bc631c45e6090bf40b26e25024de434fe0281.json
rename to packages/app-lib/.sqlx/query-e5665a8f1f5360cb236199bdc7565775a8a893b9f17401f8d9ec9148725d4940.json
index d0a642ead0..f849c1fc92 100644
--- a/packages/app-lib/.sqlx/query-26d23094e9d76e5595d5e5a0cd6bc631c45e6090bf40b26e25024de434fe0281.json
+++ b/packages/app-lib/.sqlx/query-e5665a8f1f5360cb236199bdc7565775a8a893b9f17401f8d9ec9148725d4940.json
@@ -1,6 +1,6 @@
 {
   "db_name": "SQLite",
-  "query": "\n        SELECT\n            instance_id,\n            link_kind,\n            modrinth_project_id,\n            modrinth_version_id,\n            server_project_id,\n            content_project_id,\n            content_version_id,\n            hosting_server_id,\n            json(hosting_instance_ids) AS \"hosting_instance_ids?: String\",\n            hosting_active_instance_id,\n            shared_instance_id,\n            imported_name,\n            imported_version_number,\n            imported_filename\n        FROM instance_links\n        WHERE instance_id = ?\n        ",
+  "query": "\n        SELECT\n            instance_id,\n            link_kind,\n            modrinth_project_id,\n            modrinth_version_id,\n            server_project_id,\n            content_project_id,\n            content_version_id,\n            hosting_server_id,\n            json(hosting_instance_ids) AS \"hosting_instance_ids?: String\",\n            hosting_active_instance_id,\n            shared_instance_id,\n            shared_instance_role,\n            imported_name,\n            imported_version_number,\n            imported_filename\n        FROM instance_links\n        WHERE instance_id = ?\n        ",
   "describe": {
     "columns": [
       {
@@ -59,19 +59,24 @@
         "type_info": "Text"
       },
       {
-        "name": "imported_name",
+        "name": "shared_instance_role",
         "ordinal": 11,
         "type_info": "Text"
       },
       {
-        "name": "imported_version_number",
+        "name": "imported_name",
         "ordinal": 12,
         "type_info": "Text"
       },
       {
-        "name": "imported_filename",
+        "name": "imported_version_number",
         "ordinal": 13,
         "type_info": "Text"
+      },
+      {
+        "name": "imported_filename",
+        "ordinal": 14,
+        "type_info": "Text"
       }
     ],
     "parameters": {
@@ -91,8 +96,9 @@
       true,
       true,
       true,
+      true,
       true
     ]
   },
-  "hash": "26d23094e9d76e5595d5e5a0cd6bc631c45e6090bf40b26e25024de434fe0281"
+  "hash": "e5665a8f1f5360cb236199bdc7565775a8a893b9f17401f8d9ec9148725d4940"
 }
diff --git a/packages/app-lib/.sqlx/query-eca3e44d4ba62e218289fa058dd563cebedb6b8add6c936c551a857783645ff8.json b/packages/app-lib/.sqlx/query-eca3e44d4ba62e218289fa058dd563cebedb6b8add6c936c551a857783645ff8.json
deleted file mode 100644
index 1086063a29..0000000000
--- a/packages/app-lib/.sqlx/query-eca3e44d4ba62e218289fa058dd563cebedb6b8add6c936c551a857783645ff8.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
-  "db_name": "SQLite",
-  "query": "\n\t\tINSERT INTO instance_links (\n\t\t\tinstance_id,\n\t\t\tlink_kind,\n\t\t\tmodrinth_project_id,\n\t\t\tmodrinth_version_id,\n\t\t\tserver_project_id,\n\t\t\tcontent_project_id,\n\t\t\tcontent_version_id,\n\t\t\thosting_server_id,\n\t\t\thosting_instance_ids,\n\t\t\thosting_active_instance_id,\n\t\t\tshared_instance_id,\n\t\t\timported_name,\n\t\t\timported_version_number,\n\t\t\timported_filename\n\t\t)\n\t\tVALUES (?, ?, ?, ?, ?, ?, ?, ?, jsonb(?), ?, ?, ?, ?, ?)\n\t\tON CONFLICT (instance_id) DO UPDATE SET\n\t\t\tlink_kind = excluded.link_kind,\n\t\t\tmodrinth_project_id = excluded.modrinth_project_id,\n\t\t\tmodrinth_version_id = excluded.modrinth_version_id,\n\t\t\tserver_project_id = excluded.server_project_id,\n\t\t\tcontent_project_id = excluded.content_project_id,\n\t\t\tcontent_version_id = excluded.content_version_id,\n\t\t\thosting_server_id = excluded.hosting_server_id,\n\t\t\thosting_instance_ids = excluded.hosting_instance_ids,\n\t\t\thosting_active_instance_id = excluded.hosting_active_instance_id,\n\t\t\tshared_instance_id = excluded.shared_instance_id,\n\t\t\timported_name = excluded.imported_name,\n\t\t\timported_version_number = excluded.imported_version_number,\n\t\t\timported_filename = excluded.imported_filename\n\t\t",
-  "describe": {
-    "columns": [],
-    "parameters": {
-      "Right": 14
-    },
-    "nullable": []
-  },
-  "hash": "eca3e44d4ba62e218289fa058dd563cebedb6b8add6c936c551a857783645ff8"
-}
diff --git a/packages/app-lib/migrations/20260630120000_shared-instance-role.sql b/packages/app-lib/migrations/20260630120000_shared-instance-role.sql
new file mode 100644
index 0000000000..0ee944c28f
--- /dev/null
+++ b/packages/app-lib/migrations/20260630120000_shared-instance-role.sql
@@ -0,0 +1,2 @@
+ALTER TABLE instance_links
+	ADD COLUMN shared_instance_role TEXT NULL;
diff --git a/packages/app-lib/src/api/instance.rs b/packages/app-lib/src/api/instance.rs
index 7379f1ad1d..e70c7e425c 100644
--- a/packages/app-lib/src/api/instance.rs
+++ b/packages/app-lib/src/api/instance.rs
@@ -8,6 +8,7 @@ mod lifecycle;
 mod paths;
 mod projects;
 mod run;
+mod shared;
 
 pub use self::content::{
     get_content_items, get_dependencies_as_content_items,
@@ -33,3 +34,12 @@ pub use self::projects::{
 pub use self::run::{
     QuickPlayType, kill, run, try_update_playtime_by_instance_id,
 };
+pub use self::shared::{
+    SharedInstanceExternalFilePreview, SharedInstanceInstallPreview,
+    SharedInstanceUpdateDiff, SharedInstanceUpdateDiffType,
+    SharedInstanceUpdatePreview, SharedInstanceUsers,
+    get_shared_instance_install_preview, get_shared_instance_update_preview,
+    get_shared_instance_users, install_shared_instance,
+    invite_shared_instance_users, publish_shared_instance,
+    remove_shared_instance_users, update_shared_instance,
+};
diff --git a/packages/app-lib/src/api/instance/projects.rs b/packages/app-lib/src/api/instance/projects.rs
index a88d14d87c..0a273be267 100644
--- a/packages/app-lib/src/api/instance/projects.rs
+++ b/packages/app-lib/src/api/instance/projects.rs
@@ -1,7 +1,7 @@
 use crate::event::emit::{emit_instance, emit_loading, init_loading};
 use crate::event::{InstancePayloadType, LoadingBarType};
 use crate::state::instances::adapters::sqlite::instance_rows;
-use crate::state::{ProjectType, State};
+use crate::state::{ContentSourceKind, ProjectType, SharedInstanceRole, State};
 use crate::util::fetch;
 use modrinth_content_management::{
     ContentType, ResolutionPreferences, ResolveContentPlan,
@@ -38,6 +38,7 @@ pub async fn update_all_projects(
         &state,
     )
     .await?;
+    super::shared::mark_shared_instance_stale(instance_id, &state).await?;
     emit_loading(&loading_bar, 100.0, Some("Updated instance"))?;
     emit_instance(&instance.id, InstancePayloadType::Edited).await?;
 
@@ -51,6 +52,12 @@ pub async fn update_project(
     skip_send_event: Option<bool>,
 ) -> crate::Result<String> {
     let state = State::get().await?;
+    ensure_shared_member_can_modify_project(
+        instance_id,
+        project_path,
+        &state,
+    )
+    .await?;
     let path = crate::state::instances::commands::update_project(
         instance_id,
         project_path,
@@ -58,6 +65,7 @@ pub async fn update_project(
     )
     .await?;
 
+    super::shared::mark_shared_instance_stale(instance_id, &state).await?;
     if !skip_send_event.unwrap_or(false) {
         emit_instance(instance_id, InstancePayloadType::Edited).await?;
     }
@@ -83,6 +91,7 @@ pub async fn add_project_from_version(
             &state,
         )
         .await?;
+    super::shared::mark_shared_instance_stale(instance_id, &state).await?;
     emit_instance(instance_id, InstancePayloadType::Edited).await?;
 
     Ok(project_path)
@@ -121,6 +130,16 @@ pub async fn install_project_with_dependencies(
         .await
         {
             Ok(()) => {
+                if let Err(error) = super::shared::mark_shared_instance_stale(
+                    &instance_id,
+                    &state,
+                )
+                .await
+                {
+                    tracing::error!(
+                        "Failed to mark shared instance stale after content install: {error}"
+                    );
+                }
                 if let Err(error) = emit_instance(
                     &instance_id,
                     InstancePayloadType::ContentInstallFinished {
@@ -181,6 +200,12 @@ pub async fn switch_project_version_with_dependencies(
     version_id: &str,
 ) -> crate::Result<String> {
     let state = State::get().await?;
+    ensure_shared_member_can_modify_project(
+        instance_id,
+        project_path,
+        &state,
+    )
+    .await?;
     let metadata = super::get::get(instance_id).await?.ok_or_else(|| {
         crate::ErrorKind::InputError("Unknown instance".to_string())
     })?;
@@ -192,6 +217,7 @@ pub async fn switch_project_version_with_dependencies(
             &state,
         )
         .await?;
+    super::shared::mark_shared_instance_stale(instance_id, &state).await?;
     emit_instance(&metadata.instance.id, InstancePayloadType::Edited).await?;
 
     Ok(path)
@@ -204,13 +230,18 @@ pub async fn add_project_from_path(
     project_type: Option<ProjectType>,
 ) -> crate::Result<String> {
     let state = State::get().await?;
-    crate::state::instances::commands::add_project_from_path(
-        instance_id,
-        path,
-        project_type,
-        &state,
-    )
-    .await
+    let project_path =
+        crate::state::instances::commands::add_project_from_path(
+            instance_id,
+            path,
+            project_type,
+            &state,
+        )
+        .await?;
+    super::shared::mark_shared_instance_stale(instance_id, &state).await?;
+    emit_instance(instance_id, InstancePayloadType::Edited).await?;
+
+    Ok(project_path)
 }
 
 #[tracing::instrument]
@@ -227,6 +258,7 @@ pub async fn toggle_disable_project(
         &state,
     )
     .await?;
+    super::shared::mark_shared_instance_stale(instance_id, &state).await?;
     emit_instance(instance_id, InstancePayloadType::Edited).await?;
 
     Ok(res)
@@ -238,17 +270,64 @@ pub async fn remove_project(
     project: &str,
 ) -> crate::Result<()> {
     let state = State::get().await?;
+    ensure_shared_member_can_modify_project(instance_id, project, &state)
+        .await?;
     crate::state::instances::commands::remove_project(
         instance_id,
         project,
         &state,
     )
     .await?;
+    super::shared::mark_shared_instance_stale(instance_id, &state).await?;
     emit_instance(instance_id, InstancePayloadType::Edited).await?;
 
     Ok(())
 }
 
+async fn ensure_shared_member_can_modify_project(
+    instance_id: &str,
+    project_path: &str,
+    state: &State,
+) -> crate::Result<()> {
+    let metadata = crate::state::instances::commands::get_instance_metadata(
+        instance_id,
+        &state.pool,
+    )
+    .await?
+    .ok_or_else(|| {
+        crate::ErrorKind::InputError("Unknown instance".to_string())
+    })?;
+    if !metadata
+        .shared_instance
+        .is_some_and(|attachment| attachment.role == SharedInstanceRole::Member)
+    {
+        return Ok(());
+    }
+
+    let source_kind =
+        crate::state::instances::commands::content_source_kind_for_project_path(
+            instance_id,
+            project_path,
+            state,
+        )
+        .await?;
+    if matches!(
+        source_kind,
+        Some(
+            ContentSourceKind::ModrinthModpack
+                | ContentSourceKind::ImportedModpack
+        )
+    ) {
+        return Err(crate::ErrorKind::InputError(
+            "Linked modpack content from a shared instance cannot be changed directly. Disable it instead."
+                .to_string(),
+        )
+        .into());
+    }
+
+    Ok(())
+}
+
 #[tracing::instrument]
 pub async fn update_managed_modrinth_version(
     instance_id: &str,
diff --git a/packages/app-lib/src/api/instance/run.rs b/packages/app-lib/src/api/instance/run.rs
index e4d1706de3..df99f1efb7 100644
--- a/packages/app-lib/src/api/instance/run.rs
+++ b/packages/app-lib/src/api/instance/run.rs
@@ -206,7 +206,7 @@ fn server_play_project_id(link: &InstanceLink) -> Option<&String> {
         | InstanceLink::ModrinthModpack { .. }
         | InstanceLink::ModrinthHosting { .. }
         | InstanceLink::ImportedModpack { .. }
-        | InstanceLink::SharedInstance { .. } => None,
+        | InstanceLink::SharedInstance => None,
     }
 }
 
@@ -254,7 +254,7 @@ pub async fn try_update_playtime_by_instance_id(
             | InstanceLink::ServerProject { .. }
             | InstanceLink::ModrinthHosting { .. }
             | InstanceLink::ImportedModpack { .. }
-            | InstanceLink::SharedInstance { .. } => None,
+            | InstanceLink::SharedInstance => None,
         };
         let playtime_update_json = json!({
             "seconds": updated_recent_playtime,
diff --git a/packages/app-lib/src/api/instance/shared.rs b/packages/app-lib/src/api/instance/shared.rs
new file mode 100644
index 0000000000..f08b07d033
--- /dev/null
+++ b/packages/app-lib/src/api/instance/shared.rs
@@ -0,0 +1,1262 @@
+use crate::event::InstancePayloadType;
+use crate::event::emit::emit_instance;
+use crate::install::{
+    InstallJobSnapshot, SharedInstanceExternalFileData,
+    SharedInstanceInstallData, SharedInstanceInstallModpack,
+};
+use crate::state::instances::{InstanceLink, SharedInstanceAttachment};
+use crate::state::{
+    CacheBehaviour, CachedEntry, ContentSetSyncStatus, ModLoader,
+    ModrinthCredentials, ProjectType, SharedInstanceRole, State,
+};
+use crate::util::fetch::{INSECURE_REQWEST_CLIENT, REQWEST_CLIENT};
+use reqwest::Method;
+use serde::de::DeserializeOwned;
+use serde::{Deserialize, Serialize};
+use serde_json::json;
+use std::collections::{HashMap, HashSet};
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct SharedInstanceUsers {
+    pub user_ids: Vec<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct SharedInstanceInstallPreview {
+    pub name: String,
+    pub icon_url: Option<String>,
+    pub game_version: String,
+    pub loader: ModLoader,
+    pub mod_count: usize,
+    pub external_file_count: usize,
+    pub content_version_ids: Vec<String>,
+    pub external_files: Vec<SharedInstanceExternalFilePreview>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct SharedInstanceExternalFilePreview {
+    pub file_name: String,
+    pub file_type: String,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct SharedInstanceUpdatePreview {
+    pub shared_instance_id: String,
+    pub current_version: Option<i32>,
+    pub latest_version: i32,
+    pub update_available: bool,
+    pub diffs: Vec<SharedInstanceUpdateDiff>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct SharedInstanceUpdateDiff {
+    #[serde(rename = "type")]
+    pub type_: SharedInstanceUpdateDiffType,
+    pub project_id: Option<String>,
+    pub project_name: Option<String>,
+    pub file_name: Option<String>,
+    pub current_version_name: Option<String>,
+    pub new_version_name: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum SharedInstanceUpdateDiffType {
+    Added,
+    Removed,
+    Updated,
+}
+
+#[derive(Clone, Debug)]
+struct ExternalFileCandidate {
+    file_name: String,
+    file_type: String,
+    file_path: String,
+}
+
+#[derive(Clone, Debug, Serialize)]
+struct ExternalFileData {
+    file_name: String,
+    file_type: String,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+struct CreateInstanceResponse {
+    #[serde(alias = "instance_id")]
+    id: String,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+struct InstanceVersionResponse {
+    version: i32,
+    #[serde(default)]
+    modrinth_ids: Vec<String>,
+    ready: bool,
+    #[serde(default)]
+    external_files: Vec<ExternalFileResponse>,
+    modpack_id: Option<String>,
+    #[serde(default)]
+    game_version: String,
+    #[serde(default)]
+    loader: String,
+    #[serde(default)]
+    loader_version: String,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+struct ExternalFileResponse {
+    file_name: String,
+    file_type: String,
+    url: String,
+}
+
+#[tracing::instrument]
+pub async fn get_shared_instance_users(
+    instance_id: &str,
+) -> crate::Result<SharedInstanceUsers> {
+    let state = State::get().await?;
+    let Some(attachment) = shared_attachment(instance_id, &state).await? else {
+        return Ok(SharedInstanceUsers {
+            user_ids: Vec::new(),
+        });
+    };
+
+    get_remote_users(&attachment.id, &state).await
+}
+
+#[tracing::instrument]
+pub async fn invite_shared_instance_users(
+    instance_id: &str,
+    user_ids: Vec<String>,
+) -> crate::Result<SharedInstanceUsers> {
+    let state = State::get().await?;
+    let attachment = match shared_attachment(instance_id, &state).await? {
+        Some(attachment) => {
+            tracing::debug!(
+                instance_id,
+                shared_instance_id = %attachment.id,
+                role = attachment.role.as_str(),
+                user_count = user_ids.len(),
+                "Using existing shared instance attachment for invite"
+            );
+            attachment
+        }
+        None => {
+            ensure_shareable_instance(instance_id, &state).await?;
+            tracing::info!(
+                instance_id,
+                user_count = user_ids.len(),
+                "Creating shared instance before first invite"
+            );
+            let remote = create_remote_instance(&state).await?;
+            tracing::info!(
+                instance_id,
+                shared_instance_id = %remote.id,
+                "Created remote shared instance"
+            );
+            crate::state::attach_shared_instance(
+                instance_id,
+                &remote.id,
+                SharedInstanceRole::Owner,
+                ContentSetSyncStatus::Unknown,
+                None,
+                None,
+                &state.pool,
+            )
+            .await?;
+            tracing::debug!(
+                instance_id,
+                shared_instance_id = %remote.id,
+                "Attached local instance as shared instance owner"
+            );
+            publish_shared_instance_inner(instance_id, &state).await?;
+            shared_attachment(instance_id, &state)
+                .await?
+                .ok_or_else(|| {
+                    crate::ErrorKind::InputError(
+                        "Shared instance attachment was not persisted"
+                            .to_string(),
+                    )
+                })?
+        }
+    };
+
+    ensure_owner(&attachment)?;
+    if !user_ids.is_empty() {
+        tracing::info!(
+            instance_id,
+            shared_instance_id = %attachment.id,
+            user_count = user_ids.len(),
+            "Adding users to shared instance"
+        );
+        add_remote_users(&attachment.id, user_ids.clone(), &state).await?;
+    }
+    emit_instance(instance_id, InstancePayloadType::Edited).await?;
+
+    Ok(SharedInstanceUsers { user_ids })
+}
+
+#[tracing::instrument]
+pub async fn remove_shared_instance_users(
+    instance_id: &str,
+    user_ids: Vec<String>,
+) -> crate::Result<SharedInstanceUsers> {
+    let state = State::get().await?;
+    let Some(attachment) = shared_attachment(instance_id, &state).await? else {
+        return Ok(SharedInstanceUsers {
+            user_ids: Vec::new(),
+        });
+    };
+    ensure_owner(&attachment)?;
+
+    if !user_ids.is_empty() {
+        remove_remote_users(&attachment.id, user_ids, &state).await?;
+    }
+
+    let remaining_users = get_remote_users(&attachment.id, &state).await?;
+    if remaining_users.user_ids.is_empty() {
+        delete_remote_instance(&attachment.id, &state).await?;
+        crate::state::clear_shared_instance(instance_id, &state.pool).await?;
+    }
+
+    emit_instance(instance_id, InstancePayloadType::Edited).await?;
+
+    Ok(remaining_users)
+}
+
+#[tracing::instrument]
+pub async fn publish_shared_instance(
+    instance_id: &str,
+) -> crate::Result<SharedInstanceAttachment> {
+    let state = State::get().await?;
+    publish_shared_instance_inner(instance_id, &state).await?;
+    emit_instance(instance_id, InstancePayloadType::Edited).await?;
+
+    shared_attachment(instance_id, &state)
+        .await?
+        .ok_or_else(|| {
+            crate::ErrorKind::InputError(
+                "Shared instance attachment was not persisted".to_string(),
+            )
+            .into()
+        })
+}
+
+#[tracing::instrument]
+pub async fn install_shared_instance(
+    shared_instance_id: &str,
+    name: String,
+) -> crate::Result<InstallJobSnapshot> {
+    let state = State::get().await?;
+    let version = get_latest_remote_version(shared_instance_id, &state).await?;
+    let data =
+        shared_instance_install_data(shared_instance_id, name, version, &state)
+            .await?;
+
+    crate::install::create_shared_instance(data).await
+}
+
+#[tracing::instrument]
+pub async fn get_shared_instance_install_preview(
+    shared_instance_id: &str,
+    name: String,
+) -> crate::Result<SharedInstanceInstallPreview> {
+    let state = State::get().await?;
+    let version = get_latest_remote_version(shared_instance_id, &state).await?;
+    let name = match name.trim() {
+        "" => "Shared instance".to_string(),
+        name => name.to_string(),
+    };
+    let mut icon_url = None;
+    let mut game_version = version.game_version.clone();
+    let mut loader = ModLoader::from_string(&version.loader);
+    let mut content_version_ids = version.modrinth_ids.clone();
+
+    if let Some(version_id) = version.modpack_id.as_deref() {
+        let modpack_version = CachedEntry::get_version(
+            version_id,
+            Some(CacheBehaviour::Bypass),
+            &state.pool,
+            &state.api_semaphore,
+        )
+        .await?
+        .ok_or_else(|| {
+            crate::ErrorKind::InputError(
+                "Shared instance modpack version could not be found"
+                    .to_string(),
+            )
+        })?;
+
+        if let Some(project) = CachedEntry::get_project(
+            &modpack_version.project_id,
+            Some(CacheBehaviour::Bypass),
+            &state.pool,
+            &state.api_semaphore,
+        )
+        .await?
+        {
+            icon_url = project.icon_url;
+        }
+        if let Some(version_game_version) = modpack_version.game_versions.first()
+        {
+            game_version = version_game_version.clone();
+        }
+        if let Some(version_loader) = modpack_version.loaders.first() {
+            loader = ModLoader::from_string(version_loader);
+        }
+        content_version_ids.extend(
+            modpack_version
+                .dependencies
+                .iter()
+                .filter_map(|dependency| dependency.version_id.clone()),
+        );
+    }
+    let mut seen_content_version_ids = HashSet::new();
+    content_version_ids.retain(|id| seen_content_version_ids.insert(id.clone()));
+
+    let external_files = version
+        .external_files
+        .iter()
+        .map(|file| SharedInstanceExternalFilePreview {
+            file_name: file.file_name.clone(),
+            file_type: file.file_type.clone(),
+        })
+        .collect::<Vec<_>>();
+    let external_file_count = external_files.len();
+
+    Ok(SharedInstanceInstallPreview {
+        name,
+        icon_url,
+        game_version,
+        loader,
+        mod_count: content_version_ids.len() + external_file_count,
+        external_file_count,
+        content_version_ids,
+        external_files,
+    })
+}
+
+#[tracing::instrument]
+pub async fn get_shared_instance_update_preview(
+    instance_id: &str,
+) -> crate::Result<Option<SharedInstanceUpdatePreview>> {
+    let state = State::get().await?;
+    let metadata = crate::state::get_instance(instance_id, &state.pool)
+        .await?
+        .ok_or_else(|| {
+            crate::ErrorKind::InputError("Unknown instance".to_string())
+        })?;
+    let Some(attachment) = metadata.shared_instance.clone() else {
+        return Ok(None);
+    };
+    if attachment.role != SharedInstanceRole::Member {
+        return Ok(None);
+    }
+
+    let version = get_latest_remote_version(&attachment.id, &state).await?;
+    if !version.ready {
+        return Ok(Some(SharedInstanceUpdatePreview {
+            shared_instance_id: attachment.id,
+            current_version: attachment.applied_version,
+            latest_version: version.version,
+            update_available: false,
+            diffs: Vec::new(),
+        }));
+    }
+
+    let update_available = attachment
+        .applied_version
+        .map_or(true, |current| current < version.version);
+    let diffs = if update_available {
+        shared_instance_update_diffs(&metadata, &version, &state).await?
+    } else {
+        Vec::new()
+    };
+
+    Ok(Some(SharedInstanceUpdatePreview {
+        shared_instance_id: attachment.id,
+        current_version: attachment.applied_version,
+        latest_version: version.version,
+        update_available,
+        diffs,
+    }))
+}
+
+#[tracing::instrument]
+pub async fn update_shared_instance(
+    instance_id: &str,
+) -> crate::Result<InstallJobSnapshot> {
+    let state = State::get().await?;
+    let metadata = crate::state::get_instance(instance_id, &state.pool)
+        .await?
+        .ok_or_else(|| {
+            crate::ErrorKind::InputError("Unknown instance".to_string())
+        })?;
+    let attachment = metadata.shared_instance.clone().ok_or_else(|| {
+        crate::ErrorKind::InputError(
+            "Instance is not attached to a shared instance".to_string(),
+        )
+    })?;
+    if attachment.role != SharedInstanceRole::Member {
+        return Err(crate::ErrorKind::InputError(
+            "Only shared instance members can update from shared instances"
+                .to_string(),
+        )
+        .into());
+    }
+
+    let version = get_latest_remote_version(&attachment.id, &state).await?;
+    let data = shared_instance_install_data(
+        &attachment.id,
+        metadata.instance.name,
+        version,
+        &state,
+    )
+    .await?;
+
+    crate::install::update_shared_instance(instance_id.to_string(), data).await
+}
+
+async fn shared_instance_install_data(
+    shared_instance_id: &str,
+    name: String,
+    version: InstanceVersionResponse,
+    state: &State,
+) -> crate::Result<SharedInstanceInstallData> {
+    if !version.ready {
+        return Err(crate::ErrorKind::InputError(
+            "Shared instance version is not ready to install".to_string(),
+        )
+        .into());
+    }
+
+    let name = shared_instance_name(name);
+    let modpack = match version.modpack_id.as_deref() {
+        Some(version_id) => {
+            Some(shared_instance_modpack(version_id, &name, state).await?)
+        }
+        None => None,
+    };
+    if modpack.is_none() && version.game_version.trim().is_empty() {
+        return Err(crate::ErrorKind::InputError(
+            "Shared instance version is missing Minecraft metadata".to_string(),
+        )
+        .into());
+    }
+    let loader_version = match version.loader_version.trim() {
+        "" => None,
+        _ => Some(version.loader_version.clone()),
+    };
+
+    Ok(SharedInstanceInstallData {
+        shared_instance_id: shared_instance_id.to_string(),
+        name,
+        version: version.version,
+        modrinth_ids: version.modrinth_ids,
+        external_files: version
+            .external_files
+            .into_iter()
+            .map(|file| SharedInstanceExternalFileData {
+                file_name: file.file_name,
+                file_type: file.file_type,
+                url: file.url,
+            })
+            .collect(),
+        modpack,
+        game_version: version.game_version,
+        loader: ModLoader::from_string(&version.loader),
+        loader_version,
+    })
+}
+
+async fn shared_instance_update_diffs(
+    metadata: &crate::state::InstanceMetadata,
+    version: &InstanceVersionResponse,
+    state: &State,
+) -> crate::Result<Vec<SharedInstanceUpdateDiff>> {
+    let (current_version_ids, current_external_files) =
+        current_shared_content(metadata, state).await?;
+    let (latest_version_ids, latest_external_files) =
+        remote_shared_content(version, state).await?;
+    let current_versions =
+        shared_versions_by_project(&current_version_ids, state).await?;
+    let latest_versions =
+        shared_versions_by_project(&latest_version_ids, state).await?;
+    let project_ids = current_versions
+        .keys()
+        .chain(latest_versions.keys())
+        .cloned()
+        .collect::<HashSet<_>>();
+    let project_names = shared_project_names(&project_ids, state).await?;
+
+    let mut diffs = Vec::new();
+    for project_id in project_ids {
+        let current = current_versions.get(&project_id);
+        let latest = latest_versions.get(&project_id);
+        let project_name = Some(
+            project_names
+                .get(&project_id)
+                .cloned()
+                .unwrap_or_else(|| project_id.clone()),
+        );
+
+        match (current, latest) {
+            (None, Some(latest)) => {
+                diffs.push(SharedInstanceUpdateDiff {
+                    type_: SharedInstanceUpdateDiffType::Added,
+                    project_id: Some(project_id),
+                    project_name,
+                    file_name: None,
+                    current_version_name: None,
+                    new_version_name: Some(latest.version_number.clone()),
+                });
+            }
+            (Some(current), None) => {
+                diffs.push(SharedInstanceUpdateDiff {
+                    type_: SharedInstanceUpdateDiffType::Removed,
+                    project_id: Some(project_id),
+                    project_name,
+                    file_name: None,
+                    current_version_name: Some(current.version_number.clone()),
+                    new_version_name: None,
+                });
+            }
+            (Some(current), Some(latest)) if current.id != latest.id => {
+                diffs.push(SharedInstanceUpdateDiff {
+                    type_: SharedInstanceUpdateDiffType::Updated,
+                    project_id: Some(project_id),
+                    project_name,
+                    file_name: None,
+                    current_version_name: Some(current.version_number.clone()),
+                    new_version_name: Some(latest.version_number.clone()),
+                });
+            }
+            _ => {}
+        }
+    }
+
+    for file_name in latest_external_files.difference(&current_external_files) {
+        diffs.push(SharedInstanceUpdateDiff {
+            type_: SharedInstanceUpdateDiffType::Added,
+            project_id: None,
+            project_name: None,
+            file_name: Some(file_name.clone()),
+            current_version_name: None,
+            new_version_name: None,
+        });
+    }
+    for file_name in current_external_files.difference(&latest_external_files) {
+        diffs.push(SharedInstanceUpdateDiff {
+            type_: SharedInstanceUpdateDiffType::Removed,
+            project_id: None,
+            project_name: None,
+            file_name: Some(file_name.clone()),
+            current_version_name: None,
+            new_version_name: None,
+        });
+    }
+
+    diffs.sort_by(|a, b| {
+        a.project_name
+            .as_deref()
+            .or(a.file_name.as_deref())
+            .cmp(&b.project_name.as_deref().or(b.file_name.as_deref()))
+    });
+    Ok(diffs)
+}
+
+async fn remote_shared_content(
+    version: &InstanceVersionResponse,
+    state: &State,
+) -> crate::Result<(Vec<String>, HashSet<String>)> {
+    let mut version_ids = version.modrinth_ids.clone();
+    if let Some(modpack_id) = version.modpack_id.as_deref() {
+        let modpack_version = CachedEntry::get_version(
+            modpack_id,
+            Some(CacheBehaviour::Bypass),
+            &state.pool,
+            &state.api_semaphore,
+        )
+        .await?
+        .ok_or_else(|| {
+            crate::ErrorKind::InputError(
+                "Shared instance modpack version could not be found"
+                    .to_string(),
+            )
+        })?;
+        version_ids.extend(
+            modpack_version
+                .dependencies
+                .iter()
+                .filter_map(|dependency| dependency.version_id.clone()),
+        );
+    }
+    dedupe_strings(&mut version_ids);
+
+    Ok((
+        version_ids,
+        version
+            .external_files
+            .iter()
+            .map(|file| file.file_name.clone())
+            .collect(),
+    ))
+}
+
+async fn current_shared_content(
+    metadata: &crate::state::InstanceMetadata,
+    state: &State,
+) -> crate::Result<(Vec<String>, HashSet<String>)> {
+    let entries =
+        crate::state::instances::adapters::sqlite::content_rows::get_content_entries(
+            &metadata.applied_content_set.id,
+            &state.pool,
+        )
+        .await?;
+    let files = crate::state::instances::adapters::sqlite::content_rows::get_instance_files(
+        &metadata.instance.id,
+        &state.pool,
+    )
+    .await?
+    .into_iter()
+    .map(|file| (file.id.clone(), file))
+    .collect::<HashMap<_, _>>();
+    let mut version_ids = Vec::new();
+    let mut external_files = HashSet::new();
+
+    for entry in entries {
+        if !matches!(
+            entry.source_kind,
+            crate::state::ContentSourceKind::SharedInstance
+                | crate::state::ContentSourceKind::ModrinthModpack
+                | crate::state::ContentSourceKind::ImportedModpack
+        ) {
+            continue;
+        }
+
+        if let Some(version_id) = entry.version_id {
+            version_ids.push(version_id);
+            continue;
+        }
+
+        if entry.source_kind != crate::state::ContentSourceKind::SharedInstance
+        {
+            continue;
+        }
+
+        let Some(file_id) = entry.file_id else {
+            continue;
+        };
+        if let Some(file) = files.get(&file_id) {
+            external_files.insert(file.file_name.clone());
+        }
+    }
+    dedupe_strings(&mut version_ids);
+
+    Ok((version_ids, external_files))
+}
+
+async fn shared_versions_by_project(
+    version_ids: &[String],
+    state: &State,
+) -> crate::Result<HashMap<String, crate::state::Version>> {
+    let version_id_refs =
+        version_ids.iter().map(String::as_str).collect::<Vec<_>>();
+    let versions = CachedEntry::get_version_many(
+        &version_id_refs,
+        Some(CacheBehaviour::Bypass),
+        &state.pool,
+        &state.api_semaphore,
+    )
+    .await?;
+
+    Ok(versions
+        .into_iter()
+        .map(|version| (version.project_id.clone(), version))
+        .collect())
+}
+
+async fn shared_project_names(
+    project_ids: &HashSet<String>,
+    state: &State,
+) -> crate::Result<HashMap<String, String>> {
+    let project_id_refs =
+        project_ids.iter().map(String::as_str).collect::<Vec<_>>();
+    let projects = CachedEntry::get_project_many(
+        &project_id_refs,
+        Some(CacheBehaviour::Bypass),
+        &state.pool,
+        &state.api_semaphore,
+    )
+    .await?;
+
+    Ok(projects
+        .into_iter()
+        .map(|project| (project.id, project.title))
+        .collect())
+}
+
+fn dedupe_strings(values: &mut Vec<String>) {
+    let mut seen = HashSet::new();
+    values.retain(|value| seen.insert(value.clone()));
+}
+
+fn shared_instance_name(name: String) -> String {
+    match name.trim() {
+        "" => "Shared instance".to_string(),
+        name => name.to_string(),
+    }
+}
+
+pub(crate) async fn mark_shared_instance_stale(
+    instance_id: &str,
+    state: &State,
+) -> crate::Result<()> {
+    crate::state::mark_shared_instance_stale(instance_id, &state.pool).await
+}
+
+async fn publish_shared_instance_inner(
+    instance_id: &str,
+    state: &State,
+) -> crate::Result<()> {
+    let attachment =
+        shared_attachment(instance_id, state)
+            .await?
+            .ok_or_else(|| {
+                crate::ErrorKind::InputError(
+                    "Instance is not attached to a shared instance".to_string(),
+                )
+            })?;
+    ensure_owner(&attachment)?;
+    tracing::info!(
+        instance_id,
+        shared_instance_id = %attachment.id,
+        applied_version = attachment.applied_version,
+        latest_version = attachment.latest_version,
+        "Publishing shared instance content"
+    );
+
+    crate::state::set_shared_instance_sync_status(
+        instance_id,
+        ContentSetSyncStatus::Applying,
+        attachment.applied_version,
+        attachment.latest_version,
+        &state.pool,
+    )
+    .await?;
+
+    let result =
+        publish_current_content(instance_id, &attachment.id, state).await;
+
+    match result {
+        Ok(version) => {
+            tracing::info!(
+                instance_id,
+                shared_instance_id = %attachment.id,
+                version,
+                "Published shared instance content"
+            );
+            crate::state::set_shared_instance_sync_status(
+                instance_id,
+                ContentSetSyncStatus::UpToDate,
+                Some(version),
+                Some(version),
+                &state.pool,
+            )
+            .await?;
+            Ok(())
+        }
+        Err(error) => {
+            tracing::warn!(
+                instance_id,
+                shared_instance_id = %attachment.id,
+                error = %error,
+                "Failed to publish shared instance content"
+            );
+            crate::state::set_shared_instance_sync_status(
+                instance_id,
+                ContentSetSyncStatus::Error,
+                attachment.applied_version,
+                attachment.latest_version,
+                &state.pool,
+            )
+            .await?;
+            Err(error)
+        }
+    }
+}
+
+async fn publish_current_content(
+    instance_id: &str,
+    shared_instance_id: &str,
+    state: &State,
+) -> crate::Result<i32> {
+    let metadata = crate::state::get_instance(instance_id, &state.pool)
+        .await?
+        .ok_or_else(|| {
+            crate::ErrorKind::InputError("Unknown instance".to_string())
+        })?;
+    ensure_shareable_link(&metadata.link)?;
+    let modpack_id = shared_modpack_id(&metadata.link);
+    let (modrinth_ids, external_files) =
+        collect_publish_content(instance_id, modpack_id.is_some(), state)
+            .await?;
+    tracing::debug!(
+        instance_id,
+        shared_instance_id,
+        modpack_id = modpack_id.as_deref().unwrap_or("none"),
+        modrinth_id_count = modrinth_ids.len(),
+        external_file_count = external_files.len(),
+        "Creating shared instance version"
+    );
+    let external_file_data = external_files
+        .iter()
+        .map(|file| ExternalFileData {
+            file_name: file.file_name.clone(),
+            file_type: file.file_type.clone(),
+        })
+        .collect::<Vec<_>>();
+    let response = request_json::<InstanceVersionResponse>(
+        "create_instance_version",
+        Method::POST,
+        &format!("/instances/{shared_instance_id}/versions"),
+        Some(json!({
+            "modrinth_ids": modrinth_ids,
+            "external_files": external_file_data,
+            "modpack_id": modpack_id,
+            "game_version": metadata.applied_content_set.game_version.clone(),
+            "loader": metadata.applied_content_set.loader.as_str(),
+            "loader_version": metadata
+                .applied_content_set
+                .loader_version
+                .clone()
+                .unwrap_or_default(),
+        })),
+        state,
+    )
+    .await?;
+
+    if !response.external_files.is_empty() {
+        upload_external_files(
+            &metadata.instance.path,
+            &external_files,
+            &response.external_files,
+            state,
+        )
+        .await?;
+        request_empty(
+            "mark_version_files_ready",
+            Method::POST,
+            &format!(
+                "/instances/{shared_instance_id}/versions/{}/files",
+                response.version
+            ),
+            None,
+            state,
+        )
+        .await?;
+    } else if !response.ready {
+        tracing::debug!(
+            "Shared instance version {} was not ready but had no external files",
+            response.version
+        );
+    }
+
+    Ok(response.version)
+}
+
+async fn collect_publish_content(
+    instance_id: &str,
+    exclude_linked_modpack_content: bool,
+    state: &State,
+) -> crate::Result<(Vec<String>, Vec<ExternalFileCandidate>)> {
+    let items =
+        crate::state::list_content(instance_id, None, None, state).await?;
+    let linked_modpack_items = if exclude_linked_modpack_content {
+        crate::state::list_linked_modpack_content(
+            instance_id,
+            None,
+            None,
+            state,
+        )
+        .await?
+    } else {
+        Vec::new()
+    };
+    let linked_modpack_version_ids = linked_modpack_items
+        .iter()
+        .filter_map(|item| {
+            item.version.as_ref().map(|version| version.id.clone())
+        })
+        .collect::<HashSet<_>>();
+    let linked_modpack_file_paths = linked_modpack_items
+        .iter()
+        .map(|item| item.file_path.clone())
+        .collect::<HashSet<_>>();
+
+    let mut modrinth_ids = Vec::new();
+    let mut seen_modrinth_ids = HashSet::new();
+    let mut external_files = Vec::new();
+    let mut seen_external_files = HashSet::new();
+
+    for item in items {
+        if !item.enabled {
+            continue;
+        }
+
+        if let Some(version) = item.version {
+            if linked_modpack_version_ids.contains(&version.id) {
+                continue;
+            }
+            if seen_modrinth_ids.insert(version.id.clone()) {
+                modrinth_ids.push(version.id);
+            }
+            continue;
+        }
+
+        if item.file_path.is_empty() {
+            continue;
+        }
+        if linked_modpack_file_paths.contains(&item.file_path) {
+            continue;
+        }
+
+        let file_type = file_type(item.project_type);
+        let external_key = format!("{}:{file_type}", item.file_path);
+        if seen_external_files.insert(external_key) {
+            external_files.push(ExternalFileCandidate {
+                file_name: item.file_name,
+                file_type,
+                file_path: item.file_path,
+            });
+        }
+    }
+
+    Ok((modrinth_ids, external_files))
+}
+
+fn shared_modpack_id(link: &InstanceLink) -> Option<String> {
+    match link {
+        InstanceLink::ModrinthModpack { version_id, .. } => {
+            Some(version_id.clone())
+        }
+        InstanceLink::ServerProjectModpack {
+            content_version_id, ..
+        } => Some(content_version_id.clone()),
+        _ => None,
+    }
+}
+
+async fn ensure_shareable_instance(
+    instance_id: &str,
+    state: &State,
+) -> crate::Result<()> {
+    let metadata = crate::state::get_instance(instance_id, &state.pool)
+        .await?
+        .ok_or_else(|| {
+            crate::ErrorKind::InputError("Unknown instance".to_string())
+        })?;
+    ensure_shareable_link(&metadata.link)
+}
+
+fn ensure_shareable_link(link: &InstanceLink) -> crate::Result<()> {
+    if matches!(link, InstanceLink::ImportedModpack { .. }) {
+        return Err(crate::ErrorKind::InputError(
+            "You must unlink this modpack to share your instance".to_string(),
+        )
+        .into());
+    }
+
+    Ok(())
+}
+
+async fn upload_external_files(
+    instance_path: &str,
+    candidates: &[ExternalFileCandidate],
+    uploads: &[ExternalFileResponse],
+    state: &State,
+) -> crate::Result<()> {
+    for upload in uploads {
+        let candidate = candidates
+            .iter()
+            .find(|candidate| {
+                candidate.file_name == upload.file_name
+                    && candidate.file_type == upload.file_type
+            })
+            .ok_or_else(|| {
+                crate::ErrorKind::InputError(format!(
+                    "Shared instance service requested unknown external file {}",
+                    upload.file_name
+                ))
+            })?;
+        let path = state
+            .directories
+            .instances_dir()
+            .join(instance_path)
+            .join(&candidate.file_path);
+        let bytes = crate::util::io::read(path).await?;
+        let response =
+            REQWEST_CLIENT.put(&upload.url).body(bytes).send().await?;
+
+        if !response.status().is_success() {
+            return Err(crate::ErrorKind::OtherError(format!(
+                "External file upload failed with status {}",
+                response.status()
+            ))
+            .into());
+        }
+    }
+
+    Ok(())
+}
+
+async fn shared_attachment(
+    instance_id: &str,
+    state: &State,
+) -> crate::Result<Option<SharedInstanceAttachment>> {
+    Ok(crate::state::get_instance(instance_id, &state.pool)
+        .await?
+        .and_then(|metadata| metadata.shared_instance))
+}
+
+fn ensure_owner(attachment: &SharedInstanceAttachment) -> crate::Result<()> {
+    if attachment.role == SharedInstanceRole::Owner {
+        return Ok(());
+    }
+
+    Err(crate::ErrorKind::InputError(
+        "Only the owner instance can manage shared instance users".to_string(),
+    )
+    .into())
+}
+
+fn file_type(project_type: ProjectType) -> String {
+    project_type.get_name().to_string()
+}
+
+async fn create_remote_instance(
+    state: &State,
+) -> crate::Result<CreateInstanceResponse> {
+    request_json("create_instance", Method::POST, "/instances", None, state)
+        .await
+}
+
+async fn delete_remote_instance(
+    shared_instance_id: &str,
+    state: &State,
+) -> crate::Result<()> {
+    request_empty(
+        "delete_instance",
+        Method::DELETE,
+        &format!("/instances/{shared_instance_id}"),
+        None,
+        state,
+    )
+    .await
+}
+
+async fn get_remote_users(
+    shared_instance_id: &str,
+    state: &State,
+) -> crate::Result<SharedInstanceUsers> {
+    request_json(
+        "get_instance_users",
+        Method::GET,
+        &format!("/instances/{shared_instance_id}/users"),
+        None,
+        state,
+    )
+    .await
+}
+
+async fn get_latest_remote_version(
+    shared_instance_id: &str,
+    state: &State,
+) -> crate::Result<InstanceVersionResponse> {
+    request_json(
+        "get_latest_instance_version",
+        Method::GET,
+        &format!("/instances/{shared_instance_id}/versions"),
+        None,
+        state,
+    )
+    .await
+}
+
+async fn shared_instance_modpack(
+    version_id: &str,
+    title: &str,
+    state: &State,
+) -> crate::Result<SharedInstanceInstallModpack> {
+    let version = CachedEntry::get_version(
+        version_id,
+        Some(CacheBehaviour::Bypass),
+        &state.pool,
+        &state.api_semaphore,
+    )
+    .await?
+    .ok_or_else(|| {
+        crate::ErrorKind::InputError(
+            "Shared instance modpack version could not be found".to_string(),
+        )
+    })?;
+
+    Ok(SharedInstanceInstallModpack {
+        project_id: version.project_id,
+        version_id: version_id.to_string(),
+        title: title.to_string(),
+        icon_url: None,
+    })
+}
+
+async fn add_remote_users(
+    shared_instance_id: &str,
+    user_ids: Vec<String>,
+    state: &State,
+) -> crate::Result<()> {
+    request_empty(
+        "add_instance_users",
+        Method::POST,
+        &format!("/instances/{shared_instance_id}/users"),
+        Some(json!({ "user_ids": user_ids })),
+        state,
+    )
+    .await
+}
+
+async fn remove_remote_users(
+    shared_instance_id: &str,
+    user_ids: Vec<String>,
+    state: &State,
+) -> crate::Result<()> {
+    request_empty(
+        "remove_instance_users",
+        Method::DELETE,
+        &format!("/instances/{shared_instance_id}/users"),
+        Some(json!({ "user_ids": user_ids })),
+        state,
+    )
+    .await
+}
+
+async fn request_json<T>(
+    operation: &'static str,
+    method: Method,
+    path: &str,
+    body: Option<serde_json::Value>,
+    state: &State,
+) -> crate::Result<T>
+where
+    T: DeserializeOwned,
+{
+    let response = request(operation, method, path, body, state).await?;
+    let status = response.status();
+    let body = response.text().await?;
+    tracing::debug!(
+        operation,
+        path,
+        status = status.as_u16(),
+        response_body = %body,
+        "Decoding shared instances API response"
+    );
+
+    serde_json::from_str::<T>(&body).map_err(|error| {
+        crate::ErrorKind::OtherError(format!(
+            "Shared instances API request {operation} {path} failed to decode JSON response with status {status}: {error}; body: {body}"
+        ))
+        .into()
+    })
+}
+
+async fn request_empty(
+    operation: &'static str,
+    method: Method,
+    path: &str,
+    body: Option<serde_json::Value>,
+    state: &State,
+) -> crate::Result<()> {
+    request(operation, method, path, body, state).await?;
+    Ok(())
+}
+
+async fn request(
+    operation: &'static str,
+    method: Method,
+    path: &str,
+    body: Option<serde_json::Value>,
+    state: &State,
+) -> crate::Result<reqwest::Response> {
+    let credentials =
+        ModrinthCredentials::get_and_refresh(&state.pool, &state.api_semaphore)
+            .await?
+            .ok_or(crate::ErrorKind::NoCredentialsError)?;
+    let _permit = state.api_semaphore.0.acquire().await?;
+    let base_url = service_base_url();
+    let url = service_url(base_url, path);
+    tracing::debug!(
+        operation,
+        method = method.as_str(),
+        path,
+        url = %url,
+        user_id = %credentials.user_id,
+        has_body = body.is_some(),
+        "Sending shared instances API request"
+    );
+    let mut request = shared_instances_client(base_url)
+        .request(method.clone(), &url)
+        .bearer_auth(credentials.session);
+
+    if let Some(body) = body {
+        request = request.json(&body);
+    }
+
+    let response = request.send().await?;
+    if response.status().is_success() {
+        tracing::debug!(
+            operation,
+            method = method.as_str(),
+            path,
+            url = %url,
+            status = response.status().as_u16(),
+            "Shared instances API request succeeded"
+        );
+        return Ok(response);
+    }
+
+    let status = response.status();
+    let body = response.text().await.unwrap_or_default();
+    tracing::warn!(
+        operation,
+        method = method.as_str(),
+        path,
+        url = %url,
+        user_id = %credentials.user_id,
+        status = status.as_u16(),
+        response_body = %body,
+        "Shared instances API request failed"
+    );
+    Err(crate::ErrorKind::OtherError(format!(
+        "Shared instances API request {operation} {method} {path} failed with status {status}: {body}"
+    ))
+    .into())
+}
+
+fn service_url(base_url: &str, path: &str) -> String {
+    format!("{base_url}/v1{path}")
+}
+
+fn service_base_url() -> &'static str {
+    env!("SHARED_INSTANCES_API_BASE_URL").trim_end_matches('/')
+}
+
+fn shared_instances_client(base_url: &str) -> &'static reqwest::Client {
+    if base_url.starts_with("https://") {
+        &REQWEST_CLIENT
+    } else {
+        &INSECURE_REQWEST_CLIENT
+    }
+}
diff --git a/packages/app-lib/src/api/mod.rs b/packages/app-lib/src/api/mod.rs
index 927a666aaf..4908cceeab 100644
--- a/packages/app-lib/src/api/mod.rs
+++ b/packages/app-lib/src/api/mod.rs
@@ -14,6 +14,7 @@ pub mod process;
 pub mod server_address;
 pub mod settings;
 pub mod tags;
+pub mod users;
 pub mod worlds;
 
 pub mod data {
@@ -26,7 +27,8 @@ pub mod data {
         JavaVersion, LinkedModpackInfo, MemorySettings, ModLoader,
         ModrinthCredentials, Organization, OwnerType, ProcessMetadata, Project,
         ProjectType, ProjectV3, SearchResult, SearchResults, SearchResultsV3,
-        Settings, TeamMember, Theme, User, UserFriend, Version, WindowSize,
+        Settings, SharedInstanceAttachment, SharedInstanceRole, TeamMember,
+        Theme, User, UserFriend, Version, WindowSize,
     };
     pub use ariadne::users::UserStatus;
     pub use modrinth_content_management::{
diff --git a/packages/app-lib/src/api/users.rs b/packages/app-lib/src/api/users.rs
new file mode 100644
index 0000000000..6d5f4019f6
--- /dev/null
+++ b/packages/app-lib/src/api/users.rs
@@ -0,0 +1,32 @@
+use crate::State;
+use crate::util::fetch::fetch_json;
+use reqwest::Method;
+use serde::{Deserialize, Serialize};
+
+#[derive(Serialize, Deserialize, Clone, Debug)]
+pub struct SearchUser {
+    pub id: String,
+    pub username: String,
+    pub avatar_url: Option<String>,
+}
+
+#[tracing::instrument]
+pub async fn search_user(query: &str) -> crate::Result<Vec<SearchUser>> {
+    let state = State::get().await?;
+    let query = urlencoding::encode(query);
+
+    fetch_json(
+        Method::GET,
+        &format!(
+            "{}users/search?query={}",
+            env!("MODRINTH_API_URL_V3"),
+            query
+        ),
+        None,
+        None,
+        Some("/v3/users/search"),
+        &state.api_semaphore,
+        &state.pool,
+    )
+    .await
+}
diff --git a/packages/app-lib/src/install/mod.rs b/packages/app-lib/src/install/mod.rs
index 96f9f26dfa..27d7932576 100644
--- a/packages/app-lib/src/install/mod.rs
+++ b/packages/app-lib/src/install/mod.rs
@@ -9,10 +9,13 @@ pub use model::{
     InstallErrorView, InstallJavaStep, InstallJobKind, InstallJobSnapshot,
     InstallJobStatus, InstallModpackPreview, InstallPhaseDetails,
     InstallPhaseId, InstallPostInstallEdit, InstallProgress,
-    InstallProgressSecondary, InstallRequest,
+    InstallProgressSecondary, InstallRequest, SharedInstanceExternalFileData,
+    SharedInstanceInstallData, SharedInstanceInstallModpack,
 };
 pub use runner::{
-    cancel_job, create_instance, create_modpack_instance, dismiss_job,
-    duplicate_instance, get_job, import_instance, install_existing_instance,
+    cancel_job, create_instance, create_modpack_instance,
+    create_shared_instance, dismiss_job, duplicate_instance, get_job,
+    import_instance, install_existing_instance,
     install_pack_to_existing_instance, list_jobs, retry_job,
+    update_shared_instance,
 };
diff --git a/packages/app-lib/src/install/model.rs b/packages/app-lib/src/install/model.rs
index 56b2039511..2faf7d751a 100644
--- a/packages/app-lib/src/install/model.rs
+++ b/packages/app-lib/src/install/model.rs
@@ -64,6 +64,9 @@ pub enum InstallRequest {
         #[serde(default)]
         post_install_edit: Option<InstallPostInstallEdit>,
     },
+    CreateSharedInstance {
+        data: SharedInstanceInstallData,
+    },
     ImportInstance {
         launcher_type: ImportLauncherType,
         base_path: PathBuf,
@@ -82,6 +85,10 @@ pub enum InstallRequest {
         #[serde(default)]
         post_install_edit: Option<InstallPostInstallEdit>,
     },
+    UpdateSharedInstance {
+        instance_id: String,
+        data: SharedInstanceInstallData,
+    },
 }
 
 #[derive(Serialize, Deserialize, Clone, Debug, Default)]
@@ -96,6 +103,35 @@ pub struct InstallPostInstallEdit {
     pub link: Option<InstanceLink>,
 }
 
+#[derive(Serialize, Deserialize, Clone, Debug)]
+pub struct SharedInstanceInstallData {
+    pub shared_instance_id: String,
+    pub name: String,
+    pub version: i32,
+    pub modrinth_ids: Vec<String>,
+    #[serde(default)]
+    pub external_files: Vec<SharedInstanceExternalFileData>,
+    pub modpack: Option<SharedInstanceInstallModpack>,
+    pub game_version: String,
+    pub loader: ModLoader,
+    pub loader_version: Option<String>,
+}
+
+#[derive(Serialize, Deserialize, Clone, Debug)]
+pub struct SharedInstanceExternalFileData {
+    pub file_name: String,
+    pub file_type: String,
+    pub url: String,
+}
+
+#[derive(Serialize, Deserialize, Clone, Debug)]
+pub struct SharedInstanceInstallModpack {
+    pub project_id: String,
+    pub version_id: String,
+    pub title: String,
+    pub icon_url: Option<String>,
+}
+
 impl InstallRequest {
     pub fn kind(&self) -> InstallJobKind {
         match self {
@@ -103,6 +139,9 @@ impl InstallRequest {
             Self::CreateModpackInstance { .. } => {
                 InstallJobKind::CreateModpackInstance
             }
+            Self::CreateSharedInstance { .. } => {
+                InstallJobKind::CreateSharedInstance
+            }
             Self::ImportInstance { .. } => InstallJobKind::ImportInstance,
             Self::DuplicateInstance { .. } => InstallJobKind::DuplicateInstance,
             Self::InstallExistingInstance { .. } => {
@@ -111,13 +150,17 @@ impl InstallRequest {
             Self::InstallPackToExistingInstance { .. } => {
                 InstallJobKind::InstallPackToExistingInstance
             }
+            Self::UpdateSharedInstance { .. } => {
+                InstallJobKind::UpdateSharedInstance
+            }
         }
     }
 
     pub fn target(&self) -> InstallTarget {
         match self {
             Self::InstallExistingInstance { instance_id, .. }
-            | Self::InstallPackToExistingInstance { instance_id, .. } => {
+            | Self::InstallPackToExistingInstance { instance_id, .. }
+            | Self::UpdateSharedInstance { instance_id, .. } => {
                 InstallTarget::ExistingInstance {
                     instance_id: instance_id.clone(),
                 }
@@ -129,7 +172,8 @@ impl InstallRequest {
     pub fn cleanup(&self) -> InstallCleanup {
         match self {
             Self::InstallExistingInstance { instance_id, .. }
-            | Self::InstallPackToExistingInstance { instance_id, .. } => {
+            | Self::InstallPackToExistingInstance { instance_id, .. }
+            | Self::UpdateSharedInstance { instance_id, .. } => {
                 InstallCleanup::RestoreExistingInstance {
                     instance_id: instance_id.clone(),
                 }
@@ -144,10 +188,12 @@ impl InstallRequest {
 pub enum InstallJobKind {
     CreateInstance,
     CreateModpackInstance,
+    CreateSharedInstance,
     ImportInstance,
     DuplicateInstance,
     InstallExistingInstance,
     InstallPackToExistingInstance,
+    UpdateSharedInstance,
 }
 
 impl InstallJobKind {
@@ -155,24 +201,28 @@ impl InstallJobKind {
         match self {
             Self::CreateInstance => "create_instance",
             Self::CreateModpackInstance => "create_modpack_instance",
+            Self::CreateSharedInstance => "create_shared_instance",
             Self::ImportInstance => "import_instance",
             Self::DuplicateInstance => "duplicate_instance",
             Self::InstallExistingInstance => "install_existing_instance",
             Self::InstallPackToExistingInstance => {
                 "install_pack_to_existing_instance"
             }
+            Self::UpdateSharedInstance => "update_shared_instance",
         }
     }
 
     pub fn from_stored_str(value: &str) -> Self {
         match value {
             "create_modpack_instance" => Self::CreateModpackInstance,
+            "create_shared_instance" => Self::CreateSharedInstance,
             "import_instance" => Self::ImportInstance,
             "duplicate_instance" => Self::DuplicateInstance,
             "install_existing_instance" => Self::InstallExistingInstance,
             "install_pack_to_existing_instance" => {
                 Self::InstallPackToExistingInstance
             }
+            "update_shared_instance" => Self::UpdateSharedInstance,
             _ => Self::CreateInstance,
         }
     }
diff --git a/packages/app-lib/src/install/recovery.rs b/packages/app-lib/src/install/recovery.rs
index 30529bd80e..76ac04ac37 100644
--- a/packages/app-lib/src/install/recovery.rs
+++ b/packages/app-lib/src/install/recovery.rs
@@ -72,6 +72,15 @@ fn display_from_request(state: &InstallJobState) -> Option<InstallJobDisplay> {
 			}),
 			crate::api::pack::install_from::CreatePackLocation::FromFile { .. } => None,
 		},
+		InstallRequest::CreateSharedInstance { data } => {
+			Some(InstallJobDisplay {
+				title: data.name.clone(),
+				icon: data
+					.modpack
+					.as_ref()
+					.and_then(|modpack| modpack.icon_url.clone()),
+			})
+		}
 		InstallRequest::ImportInstance {
 			instance_folder, ..
 		} => Some(InstallJobDisplay {
@@ -80,7 +89,8 @@ fn display_from_request(state: &InstallJobState) -> Option<InstallJobDisplay> {
 		}),
 		InstallRequest::DuplicateInstance { .. }
 		| InstallRequest::InstallExistingInstance { .. }
-		| InstallRequest::InstallPackToExistingInstance { .. } => {
+		| InstallRequest::InstallPackToExistingInstance { .. }
+		| InstallRequest::UpdateSharedInstance { .. } => {
 			state.rollback.as_ref().map(|rollback| InstallJobDisplay {
 				title: rollback.instance.instance.name.clone(),
 				icon: rollback.instance.instance.icon_path.clone(),
diff --git a/packages/app-lib/src/install/runner.rs b/packages/app-lib/src/install/runner.rs
index 2517319144..168bedcf15 100644
--- a/packages/app-lib/src/install/runner.rs
+++ b/packages/app-lib/src/install/runner.rs
@@ -3,7 +3,8 @@ use super::model::{
     InstallCleanup, InstallErrorView, InstallJobDisplay, InstallJobSnapshot,
     InstallJobState, InstallJobStatus, InstallPhaseDetails, InstallPhaseId,
     InstallPostInstallEdit, InstallRequest, InstallRollbackState,
-    InstallTarget,
+    InstallTarget, SharedInstanceExternalFileData, SharedInstanceInstallData,
+    SharedInstanceInstallModpack,
 };
 use super::{recovery, store};
 use crate::ErrorKind;
@@ -16,9 +17,10 @@ use crate::event::InstancePayloadType;
 use crate::event::emit::emit_instance;
 use crate::state::instances::adapters::sqlite::content_rows;
 use crate::state::{
-    ContentSourceKind, InstanceInstallStage, InstanceLink, ModLoader, State,
+    ContentSetSyncStatus, ContentSourceKind, InstanceInstallStage,
+    InstanceLink, ModLoader, ProjectType, SharedInstanceRole, State,
 };
-use crate::util::fetch::DownloadReason;
+use crate::util::fetch::{DownloadReason, REQWEST_CLIENT};
 use std::collections::HashSet;
 use std::path::PathBuf;
 use uuid::Uuid;
@@ -53,6 +55,19 @@ pub async fn create_modpack_instance(
     .await
 }
 
+pub async fn create_shared_instance(
+    data: SharedInstanceInstallData,
+) -> crate::Result<InstallJobSnapshot> {
+    start(InstallRequest::CreateSharedInstance { data }).await
+}
+
+pub async fn update_shared_instance(
+    instance_id: String,
+    data: SharedInstanceInstallData,
+) -> crate::Result<InstallJobSnapshot> {
+    start(InstallRequest::UpdateSharedInstance { instance_id, data }).await
+}
+
 pub async fn import_instance(
     launcher_type: crate::api::pack::import::ImportLauncherType,
     base_path: PathBuf,
@@ -261,6 +276,47 @@ async fn prepare_initial_instance(
             );
             set_instance_id(job_state, metadata.instance.id);
         }
+        InstallRequest::CreateSharedInstance { data } => {
+            let (game_version, loader, loader_version, icon_path) =
+                if let Some(modpack) = data.modpack.clone() {
+                    let preview = get_instance_from_pack(
+                        shared_instance_pack_location(modpack),
+                    )
+                    .await?;
+                    (
+                        preview.game_version,
+                        preview.modloader,
+                        preview.loader_version,
+                        preview
+                            .icon
+                            .as_ref()
+                            .map(|path| path.to_string_lossy().to_string())
+                            .or_else(|| preview.icon_url.clone()),
+                    )
+                } else {
+                    (
+                        data.game_version.clone(),
+                        data.loader,
+                        data.loader_version.clone(),
+                        None,
+                    )
+                };
+            let metadata = crate::api::instance::create(
+                data.name,
+                game_version,
+                loader,
+                loader_version,
+                icon_path,
+                InstanceLink::SharedInstance,
+            )
+            .await?;
+            set_display(
+                job_state,
+                metadata.instance.name,
+                metadata.instance.icon_path,
+            );
+            set_instance_id(job_state, metadata.instance.id);
+        }
         InstallRequest::ImportInstance {
             instance_folder, ..
         } => {
@@ -308,6 +364,9 @@ async fn prepare_initial_instance(
         InstallRequest::InstallExistingInstance { instance_id, .. }
         | InstallRequest::InstallPackToExistingInstance {
             instance_id, ..
+        }
+        | InstallRequest::UpdateSharedInstance {
+            instance_id, ..
         } => {
             prepare_existing_rollback(job_state, state, &instance_id).await?;
         }
@@ -471,6 +530,36 @@ async fn run_request(
             apply_post_install_edit(&instance_id, post_install_edit).await?;
             Ok(Some(instance_id))
         }
+        InstallRequest::CreateSharedInstance { data } => {
+            let Some(instance_id) = current_instance_id(job_state) else {
+                return Err(crate::ErrorKind::InputError(
+                    "Install job is missing its instance id".to_string(),
+                )
+                .into());
+            };
+            apply_shared_instance_content(
+                job_id,
+                job_state,
+                state,
+                &instance_id,
+                &data,
+            )
+            .await?;
+
+            crate::state::attach_shared_instance(
+                &instance_id,
+                &data.shared_instance_id,
+                SharedInstanceRole::Member,
+                ContentSetSyncStatus::UpToDate,
+                Some(data.version),
+                Some(data.version),
+                &state.pool,
+            )
+            .await?;
+            emit_instance(&instance_id, InstancePayloadType::Edited).await?;
+
+            Ok(Some(instance_id))
+        }
         InstallRequest::ImportInstance {
             launcher_type,
             base_path,
@@ -603,7 +692,158 @@ async fn run_request(
             apply_post_install_edit(&instance_id, post_install_edit).await?;
             Ok(Some(instance_id))
         }
+        InstallRequest::UpdateSharedInstance { instance_id, data } => {
+            prepare_existing_rollback(job_state, state, &instance_id).await?;
+            let disabled_project_ids =
+                remove_existing_shared_instance_content(&instance_id, state)
+                    .await?;
+            apply_shared_instance_content(
+                job_id,
+                job_state,
+                state,
+                &instance_id,
+                &data,
+            )
+            .await?;
+            restore_disabled_projects(
+                &instance_id,
+                disabled_project_ids,
+                state,
+            )
+            .await?;
+            crate::state::attach_shared_instance(
+                &instance_id,
+                &data.shared_instance_id,
+                SharedInstanceRole::Member,
+                ContentSetSyncStatus::UpToDate,
+                Some(data.version),
+                Some(data.version),
+                &state.pool,
+            )
+            .await?;
+            emit_instance(&instance_id, InstancePayloadType::Edited).await?;
+            Ok(Some(instance_id))
+        }
+    }
+}
+
+async fn apply_shared_instance_content(
+    job_id: Uuid,
+    job_state: &mut InstallJobState,
+    state: &State,
+    instance_id: &str,
+    data: &SharedInstanceInstallData,
+) -> crate::Result<()> {
+    update_progress(
+        job_id,
+        job_state,
+        state,
+        InstallPhaseId::PreparingInstance,
+        InstallPhaseDetails::Instance {
+            name: data.name.clone(),
+        },
+    )
+    .await?;
+
+    if let Some(modpack) = data.modpack.clone() {
+        let location = shared_instance_pack_location(modpack);
+        update_progress(
+            job_id,
+            job_state,
+            state,
+            InstallPhaseId::ResolvingPack,
+            modpack_details(&location),
+        )
+        .await?;
+        install_pack(
+            job_id,
+            job_state,
+            location,
+            instance_id.to_string(),
+            DownloadReason::Modpack,
+        )
+        .await?;
+    } else {
+        crate::api::instance::edit(
+            instance_id,
+            crate::state::EditInstance {
+                content_set_patch: Some(crate::state::AppliedContentSetPatch {
+                    source_kind: Some(ContentSourceKind::SharedInstance),
+                    game_version: Some(data.game_version.clone()),
+                    protocol_version: Some(None),
+                    loader: Some(data.loader),
+                    loader_version: Some(data.loader_version.clone()),
+                }),
+                ..Default::default()
+            },
+        )
+        .await?;
+        update_progress(
+            job_id,
+            job_state,
+            state,
+            InstallPhaseId::DownloadingMinecraft,
+            InstallPhaseDetails::Minecraft {
+                game_version: data.game_version.clone(),
+                loader: data.loader,
+            },
+        )
+        .await?;
+        let context =
+            crate::state::instances::commands::get_instance_launch_context(
+                instance_id,
+                &state.pool,
+            )
+            .await?
+            .ok_or_else(|| {
+                crate::ErrorKind::InputError("Unknown instance".to_string())
+            })?;
+        crate::launcher::install_minecraft_with_reporter(
+            &context,
+            false,
+            Some(InstallProgressReporter::new(job_id, job_state.clone())),
+        )
+        .await?;
+    }
+
+    if !data.modrinth_ids.is_empty() || !data.external_files.is_empty() {
+        update_progress(
+            job_id,
+            job_state,
+            state,
+            InstallPhaseId::DownloadingContent,
+            InstallPhaseDetails::Empty,
+        )
+        .await?;
+        for version_id in &data.modrinth_ids {
+            crate::state::instances::commands::add_project_from_version(
+                instance_id,
+                version_id,
+                DownloadReason::Standalone,
+                None,
+                ContentSourceKind::SharedInstance,
+                state,
+            )
+            .await?;
+        }
+
+        for file in &data.external_files {
+            install_shared_instance_external_file(instance_id, file, state)
+                .await?;
+        }
     }
+
+    crate::api::instance::edit(
+        instance_id,
+        crate::state::EditInstance {
+            name: Some(data.name.clone()),
+            link: Some(InstanceLink::SharedInstance),
+            ..Default::default()
+        },
+    )
+    .await?;
+
+    Ok(())
 }
 
 async fn apply_post_install_edit(
@@ -633,6 +873,81 @@ async fn apply_post_install_edit(
     Ok(())
 }
 
+async fn remove_existing_shared_instance_content(
+    instance_id: &str,
+    state: &State,
+) -> crate::Result<HashSet<String>> {
+    let metadata = crate::state::instances::commands::get_instance_metadata(
+        instance_id,
+        &state.pool,
+    )
+    .await?
+    .ok_or_else(|| {
+        crate::ErrorKind::InputError("Unknown instance".to_string())
+    })?;
+    let disabled_project_ids =
+        crate::state::instances::commands::list_project_files(
+            instance_id,
+            state,
+        )
+        .await?
+        .into_iter()
+        .filter_map(|file| (!file.enabled).then_some(file.project_id?))
+        .collect::<HashSet<_>>();
+    let entries = content_rows::get_content_entries(
+        &metadata.applied_content_set.id,
+        &state.pool,
+    )
+    .await?;
+    let files = content_rows::get_instance_files(instance_id, &state.pool)
+        .await?
+        .into_iter()
+        .map(|file| (file.id.clone(), file))
+        .collect::<std::collections::HashMap<_, _>>();
+    let base = state
+        .directories
+        .instances_dir()
+        .join(&metadata.instance.path);
+
+    let mut removed_file_ids = HashSet::new();
+    for entry in entries {
+        if !matches!(
+            entry.source_kind,
+            ContentSourceKind::SharedInstance
+                | ContentSourceKind::ModrinthModpack
+                | ContentSourceKind::ImportedModpack
+        ) {
+            continue;
+        }
+
+        let Some(file_id) = entry.file_id else {
+            continue;
+        };
+        if !removed_file_ids.insert(file_id.clone()) {
+            continue;
+        }
+
+        let Some(file) = files.get(&file_id) else {
+            continue;
+        };
+        crate::util::io::remove_file(base.join(&file.relative_path)).await?;
+        content_rows::remove_content_entries_for_file(
+            &metadata.applied_content_set.id,
+            &file.id,
+            &state.pool,
+        )
+        .await?;
+        content_rows::remove_instance_file_by_relative_path(
+            instance_id,
+            &file.relative_path,
+            &state.pool,
+        )
+        .await?;
+    }
+
+    Ok(disabled_project_ids)
+}
+
 async fn remove_existing_pack_content(
     job_id: Uuid,
     job_state: &InstallJobState,
@@ -978,3 +1293,52 @@ fn modpack_details(location: &CreatePackLocation) -> InstallPhaseDetails {
         },
     }
 }
+
+fn shared_instance_pack_location(
+    modpack: SharedInstanceInstallModpack,
+) -> CreatePackLocation {
+    CreatePackLocation::FromVersionId {
+        project_id: modpack.project_id,
+        version_id: modpack.version_id,
+        title: modpack.title,
+        icon_url: modpack.icon_url,
+    }
+}
+
+async fn install_shared_instance_external_file(
+    instance_id: &str,
+    file: &SharedInstanceExternalFileData,
+    state: &State,
+) -> crate::Result<()> {
+    let project_type =
+        ProjectType::from_name(&file.file_type).ok_or_else(|| {
+            crate::ErrorKind::InputError(format!(
+                "Unknown shared instance file type {}",
+                file.file_type
+            ))
+        })?;
+    let response = REQWEST_CLIENT.get(&file.url).send().await?;
+
+    if !response.status().is_success() {
+        return Err(crate::ErrorKind::OtherError(format!(
+            "Shared instance external file download failed with status {}",
+            response.status()
+        ))
+        .into());
+    }
+
+    crate::state::instances::commands::add_project_bytes(
+        instance_id,
+        &file.file_name,
+        response.bytes().await?,
+        None,
+        Some(project_type),
+        ContentSourceKind::SharedInstance,
+        None,
+        None,
+        state,
+    )
+    .await?;
+
+    Ok(())
+}
diff --git a/packages/app-lib/src/launcher/mod.rs b/packages/app-lib/src/launcher/mod.rs
index a3d4a0a8b1..881c6198a6 100644
--- a/packages/app-lib/src/launcher/mod.rs
+++ b/packages/app-lib/src/launcher/mod.rs
@@ -671,7 +671,7 @@ fn link_project_and_version(
         } => (project_id.as_ref(), version_id.as_ref()),
         InstanceLink::Unmanaged
         | InstanceLink::ModrinthHosting { .. }
-        | InstanceLink::SharedInstance { .. } => (None, None),
+        | InstanceLink::SharedInstance => (None, None),
     }
 }
 
diff --git a/packages/app-lib/src/state/instance_types.rs b/packages/app-lib/src/state/instance_types.rs
index 4fefab25a1..f480d22f0a 100644
--- a/packages/app-lib/src/state/instance_types.rs
+++ b/packages/app-lib/src/state/instance_types.rs
@@ -1,6 +1,8 @@
 use serde::{Deserialize, Serialize};
 use std::path::Path;
 
+use super::instances::ContentSourceKind;
+
 #[derive(Serialize, Deserialize, Clone, Copy, Debug, Eq, PartialEq)]
 #[serde(rename_all = "snake_case")]
 pub enum InstanceInstallStage {
@@ -122,6 +124,7 @@ pub struct ContentFile {
     pub metadata: Option<FileMetadata>,
     pub update_version_id: Option<String>,
     pub project_type: ProjectType,
+    pub source_kind: Option<ContentSourceKind>,
 }
 
 #[derive(Debug, Serialize, Deserialize, Clone)]
@@ -186,6 +189,18 @@ impl ProjectType {
         }
     }
 
+    pub fn from_name(name: &str) -> Option<Self> {
+        match name {
+            "mod" | "mods" => Some(ProjectType::Mod),
+            "datapack" | "datapacks" => Some(ProjectType::DataPack),
+            "resourcepack" | "resourcepacks" => Some(ProjectType::ResourcePack),
+            "shader" | "shaderpack" | "shaderpacks" => {
+                Some(ProjectType::ShaderPack)
+            }
+            _ => None,
+        }
+    }
+
     pub fn get_folder(&self) -> &'static str {
         match self {
             ProjectType::Mod => "mods",
diff --git a/packages/app-lib/src/state/instances/adapters/sqlite/content_rows.rs b/packages/app-lib/src/state/instances/adapters/sqlite/content_rows.rs
index 0a27b105cd..b4dc37feb0 100644
--- a/packages/app-lib/src/state/instances/adapters/sqlite/content_rows.rs
+++ b/packages/app-lib/src/state/instances/adapters/sqlite/content_rows.rs
@@ -374,6 +374,56 @@ where
     rows.into_iter().map(TryInto::try_into).collect()
 }
 
+pub(crate) async fn upsert_content_set_remote_ref(
+    remote_ref: &ContentSetRemoteRef,
+    tx: &mut Transaction<'_, Sqlite>,
+) -> crate::Result<()> {
+    let content_set_id = remote_ref.content_set_id.as_str();
+    let ref_type = remote_ref.ref_type.as_str();
+    let ref_id = remote_ref.ref_id.as_str();
+
+    sqlx::query!(
+        "
+		INSERT INTO instance_content_set_remote_refs (
+			content_set_id,
+			ref_type,
+			ref_id
+		)
+		VALUES (?, ?, ?)
+		ON CONFLICT (content_set_id, ref_type) DO UPDATE SET
+			ref_id = excluded.ref_id
+		",
+        content_set_id,
+        ref_type,
+        ref_id,
+    )
+    .execute(&mut **tx)
+    .await?;
+
+    Ok(())
+}
+
+pub(crate) async fn delete_content_set_remote_ref(
+    content_set_id: &str,
+    ref_type: ContentSetRemoteRefType,
+    tx: &mut Transaction<'_, Sqlite>,
+) -> crate::Result<()> {
+    let ref_type = ref_type.as_str();
+
+    sqlx::query!(
+        "
+		DELETE FROM instance_content_set_remote_refs
+		WHERE content_set_id = ? AND ref_type = ?
+		",
+        content_set_id,
+        ref_type,
+    )
+    .execute(&mut **tx)
+    .await?;
+
+    Ok(())
+}
+
 pub(crate) async fn get_content_set_sync_state<'e, E>(
     content_set_id: &str,
     exec: E,
@@ -396,6 +446,66 @@ where
     row.map(TryInto::try_into).transpose()
 }
 
+pub(crate) async fn upsert_content_set_sync_state(
+    sync_state: &ContentSetSyncState,
+    tx: &mut Transaction<'_, Sqlite>,
+) -> crate::Result<()> {
+    let content_set_id = sync_state.content_set_id.as_str();
+    let provider = sync_state.provider.as_str();
+    let applied_update_id = sync_state.applied_update_id.as_deref();
+    let latest_available_update_id =
+        sync_state.latest_available_update_id.as_deref();
+    let checked_at = sync_state.checked_at.map(|value| value.timestamp());
+    let status = sync_state.status.as_str();
+
+    sqlx::query!(
+        "
+		INSERT INTO instance_content_set_sync_state (
+			content_set_id,
+			provider,
+			applied_update_id,
+			latest_available_update_id,
+			checked_at,
+			status
+		)
+		VALUES (?, ?, ?, ?, ?, ?)
+		ON CONFLICT (content_set_id) DO UPDATE SET
+			provider = excluded.provider,
+			applied_update_id = excluded.applied_update_id,
+			latest_available_update_id = excluded.latest_available_update_id,
+			checked_at = excluded.checked_at,
+			status = excluded.status
+		",
+        content_set_id,
+        provider,
+        applied_update_id,
+        latest_available_update_id,
+        checked_at,
+        status,
+    )
+    .execute(&mut **tx)
+    .await?;
+
+    Ok(())
+}
+
+pub(crate) async fn delete_content_set_sync_state(
+    content_set_id: &str,
+    tx: &mut Transaction<'_, Sqlite>,
+) -> crate::Result<()> {
+    sqlx::query!(
+        "
+		DELETE FROM instance_content_set_sync_state
+		WHERE content_set_id = ?
+		",
+        content_set_id,
+    )
+    .execute(&mut **tx)
+    .await?;
+
+    Ok(())
+}
+
 pub(crate) async fn get_instance_files<'e, E>(
     instance_id: &str,
     exec: E,
@@ -1011,16 +1121,12 @@ pub(crate) async fn upsert_content_update_check(
 }
 
 fn project_type_from_str(value: &str) -> crate::Result<ProjectType> {
-    match value {
-        "mod" => Ok(ProjectType::Mod),
-        "datapack" => Ok(ProjectType::DataPack),
-        "resourcepack" => Ok(ProjectType::ResourcePack),
-        "shader" | "shaderpack" => Ok(ProjectType::ShaderPack),
-        other => Err(crate::ErrorKind::InputError(format!(
-            "Unknown content project type {other}"
+    ProjectType::from_name(value).ok_or_else(|| {
+        crate::ErrorKind::InputError(format!(
+            "Unknown content project type {value}"
         ))
-        .into()),
-    }
+        .into()
+    })
 }
 
 fn timestamp(value: i64) -> DateTime<Utc> {
diff --git a/packages/app-lib/src/state/instances/adapters/sqlite/instance_rows.rs b/packages/app-lib/src/state/instances/adapters/sqlite/instance_rows.rs
index 5a4a0e6141..074692649b 100644
--- a/packages/app-lib/src/state/instances/adapters/sqlite/instance_rows.rs
+++ b/packages/app-lib/src/state/instances/adapters/sqlite/instance_rows.rs
@@ -1,9 +1,10 @@
 #![allow(dead_code)]
 
 use crate::state::instances::{
-    ContentSet, ContentSetStatus, ContentSourceKind, Instance,
-    InstanceLaunchContext, InstanceLaunchOverrides,
-    InstanceLaunchOverridesData, InstanceLink, playtime_to_storage,
+    ContentSet, ContentSetStatus, ContentSetSyncStatus, ContentSourceKind,
+    Instance, InstanceLaunchContext, InstanceLaunchOverrides,
+    InstanceLaunchOverridesData, InstanceLink, SharedInstanceAttachment,
+    SharedInstanceRole, playtime_to_storage,
 };
 use crate::state::{
     InstanceInstallStage, LauncherFeatureVersion, ModLoader, ReleaseChannel,
@@ -73,6 +74,7 @@ pub(crate) struct InstanceLinkRow {
     pub hosting_instance_ids: Option<String>,
     pub hosting_active_instance_id: Option<String>,
     pub shared_instance_id: Option<String>,
+    pub shared_instance_role: Option<String>,
     pub imported_name: Option<String>,
     pub imported_version_number: Option<String>,
     pub imported_filename: Option<String>,
@@ -136,12 +138,7 @@ impl TryFrom<InstanceLinkRow> for InstanceLink {
                 version_number: row.imported_version_number,
                 filename: row.imported_filename,
             }),
-            "shared_instance" => Ok(Self::SharedInstance {
-                shared_instance_id: parse_uuid(
-                    row.shared_instance_id,
-                    "shared_instance_id",
-                )?,
-            }),
+            "shared_instance" => Ok(Self::SharedInstance),
             other => Err(crate::ErrorKind::InputError(format!(
                 "Unknown instance link kind {other}"
             ))
@@ -161,6 +158,7 @@ pub(crate) struct InstanceMetadataRecord {
     pub instance: Instance,
     pub applied_content_set: ContentSet,
     pub link: InstanceLink,
+    pub shared_instance: Option<SharedInstanceAttachment>,
     pub groups: Vec<String>,
     pub launch_overrides: InstanceLaunchOverrides,
 }
@@ -207,6 +205,10 @@ struct InstanceMetadataRow {
     hosting_instance_ids: Option<String>,
     hosting_active_instance_id: Option<String>,
     shared_instance_id: Option<String>,
+    shared_instance_role: Option<String>,
+    shared_sync_applied_update_id: Option<String>,
+    shared_sync_latest_available_update_id: Option<String>,
+    shared_sync_status: Option<String>,
     imported_name: Option<String>,
     imported_version_number: Option<String>,
     imported_filename: Option<String>,
@@ -300,12 +302,20 @@ impl InstanceMetadataRow {
             hosting_server_id: self.hosting_server_id,
             hosting_instance_ids: self.hosting_instance_ids,
             hosting_active_instance_id: self.hosting_active_instance_id,
-            shared_instance_id: self.shared_instance_id,
+            shared_instance_id: self.shared_instance_id.clone(),
+            shared_instance_role: self.shared_instance_role.clone(),
             imported_name: self.imported_name,
             imported_version_number: self.imported_version_number,
             imported_filename: self.imported_filename,
         }
         .try_into()?;
+        let shared_instance = shared_instance_attachment(
+            self.shared_instance_id,
+            self.shared_instance_role,
+            self.shared_sync_status,
+            self.shared_sync_applied_update_id,
+            self.shared_sync_latest_available_update_id,
+        )?;
         let groups = parse_groups(self.groups)?;
         let launch_overrides =
             launch_overrides_from_json(instance_id, self.launch_overrides)?;
@@ -314,6 +324,7 @@ impl InstanceMetadataRow {
             instance,
             applied_content_set,
             link,
+            shared_instance,
             groups,
             launch_overrides,
         })
@@ -460,6 +471,10 @@ pub(crate) async fn get_instance_metadata_by_id(
             json(link.hosting_instance_ids) AS "hosting_instance_ids?: String",
             link.hosting_active_instance_id AS "hosting_active_instance_id?: String",
             link.shared_instance_id AS "shared_instance_id?: String",
+            link.shared_instance_role AS "shared_instance_role?: String",
+            sync.applied_update_id AS "shared_sync_applied_update_id?: String",
+            sync.latest_available_update_id AS "shared_sync_latest_available_update_id?: String",
+            sync.status AS "shared_sync_status?: String",
             link.imported_name AS "imported_name?: String",
             link.imported_version_number AS "imported_version_number?: String",
             link.imported_filename AS "imported_filename?: String",
@@ -479,6 +494,9 @@ pub(crate) async fn get_instance_metadata_by_id(
             AND cs.instance_id = i.id
         LEFT JOIN instance_links link
             ON link.instance_id = i.id
+        LEFT JOIN instance_content_set_sync_state sync
+            ON sync.content_set_id = cs.id
+            AND sync.provider = 'shared_instance'
         LEFT JOIN instance_launch_overrides overrides
             ON overrides.instance_id = i.id
         WHERE i.id = ?
@@ -542,6 +560,10 @@ pub(crate) async fn get_instance_metadata_many(
             json(link.hosting_instance_ids) AS "hosting_instance_ids?: String",
             link.hosting_active_instance_id AS "hosting_active_instance_id?: String",
             link.shared_instance_id AS "shared_instance_id?: String",
+            link.shared_instance_role AS "shared_instance_role?: String",
+            sync.applied_update_id AS "shared_sync_applied_update_id?: String",
+            sync.latest_available_update_id AS "shared_sync_latest_available_update_id?: String",
+            sync.status AS "shared_sync_status?: String",
             link.imported_name AS "imported_name?: String",
             link.imported_version_number AS "imported_version_number?: String",
             link.imported_filename AS "imported_filename?: String",
@@ -563,6 +585,9 @@ pub(crate) async fn get_instance_metadata_many(
             AND cs.instance_id = i.id
         LEFT JOIN instance_links link
             ON link.instance_id = i.id
+        LEFT JOIN instance_content_set_sync_state sync
+            ON sync.content_set_id = cs.id
+            AND sync.provider = 'shared_instance'
         LEFT JOIN instance_launch_overrides overrides
             ON overrides.instance_id = i.id
         ORDER BY requested.ord
@@ -618,6 +643,10 @@ pub(crate) async fn list_instance_metadata(
             json(link.hosting_instance_ids) AS "hosting_instance_ids?: String",
             link.hosting_active_instance_id AS "hosting_active_instance_id?: String",
             link.shared_instance_id AS "shared_instance_id?: String",
+            link.shared_instance_role AS "shared_instance_role?: String",
+            sync.applied_update_id AS "shared_sync_applied_update_id?: String",
+            sync.latest_available_update_id AS "shared_sync_latest_available_update_id?: String",
+            sync.status AS "shared_sync_status?: String",
             link.imported_name AS "imported_name?: String",
             link.imported_version_number AS "imported_version_number?: String",
             link.imported_filename AS "imported_filename?: String",
@@ -637,6 +666,9 @@ pub(crate) async fn list_instance_metadata(
             AND cs.instance_id = i.id
         LEFT JOIN instance_links link
             ON link.instance_id = i.id
+        LEFT JOIN instance_content_set_sync_state sync
+            ON sync.content_set_id = cs.id
+            AND sync.provider = 'shared_instance'
         LEFT JOIN instance_launch_overrides overrides
             ON overrides.instance_id = i.id
         "#,
@@ -691,6 +723,10 @@ pub(crate) async fn get_instance_launch_context(
             json(link.hosting_instance_ids) AS "hosting_instance_ids?: String",
             link.hosting_active_instance_id AS "hosting_active_instance_id?: String",
             link.shared_instance_id AS "shared_instance_id?: String",
+            link.shared_instance_role AS "shared_instance_role?: String",
+            sync.applied_update_id AS "shared_sync_applied_update_id?: String",
+            sync.latest_available_update_id AS "shared_sync_latest_available_update_id?: String",
+            sync.status AS "shared_sync_status?: String",
             link.imported_name AS "imported_name?: String",
             link.imported_version_number AS "imported_version_number?: String",
             link.imported_filename AS "imported_filename?: String",
@@ -702,6 +738,9 @@ pub(crate) async fn get_instance_launch_context(
             AND cs.instance_id = i.id
         LEFT JOIN instance_links link
             ON link.instance_id = i.id
+        LEFT JOIN instance_content_set_sync_state sync
+            ON sync.content_set_id = cs.id
+            AND sync.provider = 'shared_instance'
         LEFT JOIN instance_launch_overrides overrides
             ON overrides.instance_id = i.id
         WHERE i.id = ?
@@ -753,6 +792,7 @@ where
             json(hosting_instance_ids) AS "hosting_instance_ids?: String",
             hosting_active_instance_id,
             shared_instance_id,
+            shared_instance_role,
             imported_name,
             imported_version_number,
             imported_filename
@@ -949,7 +989,6 @@ pub(crate) async fn upsert_instance_link(
     let hosting_instance_ids = columns.hosting_instance_ids.as_deref();
     let hosting_active_instance_id =
         columns.hosting_active_instance_id.as_deref();
-    let shared_instance_id = columns.shared_instance_id.as_deref();
     let imported_name = columns.imported_name.as_deref();
     let imported_version_number = columns.imported_version_number.as_deref();
     let imported_filename = columns.imported_filename.as_deref();
@@ -967,12 +1006,11 @@ pub(crate) async fn upsert_instance_link(
 			hosting_server_id,
 			hosting_instance_ids,
 			hosting_active_instance_id,
-			shared_instance_id,
 			imported_name,
 			imported_version_number,
 			imported_filename
 		)
-		VALUES (?, ?, ?, ?, ?, ?, ?, ?, jsonb(?), ?, ?, ?, ?, ?)
+		VALUES (?, ?, ?, ?, ?, ?, ?, ?, jsonb(?), ?, ?, ?, ?)
 		ON CONFLICT (instance_id) DO UPDATE SET
 			link_kind = excluded.link_kind,
 			modrinth_project_id = excluded.modrinth_project_id,
@@ -983,7 +1021,6 @@ pub(crate) async fn upsert_instance_link(
 			hosting_server_id = excluded.hosting_server_id,
 			hosting_instance_ids = excluded.hosting_instance_ids,
 			hosting_active_instance_id = excluded.hosting_active_instance_id,
-			shared_instance_id = excluded.shared_instance_id,
 			imported_name = excluded.imported_name,
 			imported_version_number = excluded.imported_version_number,
 			imported_filename = excluded.imported_filename
@@ -998,7 +1035,6 @@ pub(crate) async fn upsert_instance_link(
         hosting_server_id,
         hosting_instance_ids,
         hosting_active_instance_id,
-        shared_instance_id,
         imported_name,
         imported_version_number,
         imported_filename,
@@ -1009,6 +1045,44 @@ pub(crate) async fn upsert_instance_link(
     Ok(())
 }
 
+pub(crate) async fn set_shared_instance_attachment(
+    instance_id: &str,
+    attachment: Option<&SharedInstanceAttachment>,
+    tx: &mut Transaction<'_, Sqlite>,
+) -> crate::Result<()> {
+    let shared_instance_id = attachment.map(|value| value.id.to_string());
+    let shared_instance_role =
+        attachment.map(|value| value.role.as_str().to_string());
+
+    sqlx::query!(
+        "
+		INSERT INTO instance_links (
+			instance_id,
+			link_kind,
+			shared_instance_id,
+			shared_instance_role
+		)
+		VALUES (?, 'unmanaged', ?, ?)
+		ON CONFLICT (instance_id) DO UPDATE SET
+			link_kind = CASE
+				WHEN excluded.shared_instance_id IS NULL
+					AND instance_links.link_kind = 'shared_instance'
+					THEN 'unmanaged'
+				ELSE instance_links.link_kind
+			END,
+			shared_instance_id = excluded.shared_instance_id,
+			shared_instance_role = excluded.shared_instance_role
+		",
+        instance_id,
+        shared_instance_id,
+        shared_instance_role,
+    )
+    .execute(&mut **tx)
+    .await?;
+
+    Ok(())
+}
+
 pub(crate) async fn replace_instance_groups(
     instance_id: &str,
     groups: &[String],
@@ -1094,7 +1168,6 @@ struct InstanceLinkColumns {
     hosting_server_id: Option<String>,
     hosting_instance_ids: Option<String>,
     hosting_active_instance_id: Option<String>,
-    shared_instance_id: Option<String>,
     imported_name: Option<String>,
     imported_version_number: Option<String>,
     imported_filename: Option<String>,
@@ -1114,7 +1187,6 @@ fn instance_link_columns(
             hosting_server_id: None,
             hosting_instance_ids: None,
             hosting_active_instance_id: None,
-            shared_instance_id: None,
             imported_name: None,
             imported_version_number: None,
             imported_filename: None,
@@ -1132,7 +1204,6 @@ fn instance_link_columns(
             hosting_server_id: None,
             hosting_instance_ids: None,
             hosting_active_instance_id: None,
-            shared_instance_id: None,
             imported_name: None,
             imported_version_number: None,
             imported_filename: None,
@@ -1147,7 +1218,6 @@ fn instance_link_columns(
             hosting_server_id: None,
             hosting_instance_ids: None,
             hosting_active_instance_id: None,
-            shared_instance_id: None,
             imported_name: None,
             imported_version_number: None,
             imported_filename: None,
@@ -1166,7 +1236,6 @@ fn instance_link_columns(
             hosting_server_id: None,
             hosting_instance_ids: None,
             hosting_active_instance_id: None,
-            shared_instance_id: None,
             imported_name: None,
             imported_version_number: None,
             imported_filename: None,
@@ -1186,7 +1255,6 @@ fn instance_link_columns(
             hosting_instance_ids: Some(serde_json::to_string(instance_ids)?),
             hosting_active_instance_id: active_instance_id
                 .map(|value| value.to_string()),
-            shared_instance_id: None,
             imported_name: None,
             imported_version_number: None,
             imported_filename: None,
@@ -1207,28 +1275,24 @@ fn instance_link_columns(
             hosting_server_id: None,
             hosting_instance_ids: None,
             hosting_active_instance_id: None,
-            shared_instance_id: None,
             imported_name: name.clone(),
             imported_version_number: version_number.clone(),
             imported_filename: filename.clone(),
         }),
-        InstanceLink::SharedInstance { shared_instance_id } => {
-            Ok(InstanceLinkColumns {
-                link_kind: "shared_instance",
-                modrinth_project_id: None,
-                modrinth_version_id: None,
-                server_project_id: None,
-                content_project_id: None,
-                content_version_id: None,
-                hosting_server_id: None,
-                hosting_instance_ids: None,
-                hosting_active_instance_id: None,
-                shared_instance_id: Some(shared_instance_id.to_string()),
-                imported_name: None,
-                imported_version_number: None,
-                imported_filename: None,
-            })
-        }
+        InstanceLink::SharedInstance => Ok(InstanceLinkColumns {
+            link_kind: "shared_instance",
+            modrinth_project_id: None,
+            modrinth_version_id: None,
+            server_project_id: None,
+            content_project_id: None,
+            content_version_id: None,
+            hosting_server_id: None,
+            hosting_instance_ids: None,
+            hosting_active_instance_id: None,
+            imported_name: None,
+            imported_version_number: None,
+            imported_filename: None,
+        }),
     }
 }
 
@@ -1273,6 +1337,52 @@ fn launch_overrides_from_json(
     }
 }
 
+fn shared_instance_attachment(
+    shared_instance_id: Option<String>,
+    shared_instance_role: Option<String>,
+    shared_sync_status: Option<String>,
+    applied_update_id: Option<String>,
+    latest_available_update_id: Option<String>,
+) -> crate::Result<Option<SharedInstanceAttachment>> {
+    let Some(id) = shared_instance_id else {
+        return Ok(None);
+    };
+
+    let role = match shared_instance_role {
+        Some(role) => SharedInstanceRole::from_str(&role)?,
+        None => SharedInstanceRole::Member,
+    };
+    let status = match shared_sync_status {
+        Some(status) => ContentSetSyncStatus::from_str(&status)?,
+        None => ContentSetSyncStatus::Unknown,
+    };
+
+    Ok(Some(SharedInstanceAttachment {
+        id,
+        role,
+        status,
+        applied_version: optional_i32(applied_update_id, "applied_update_id")?,
+        latest_version: optional_i32(
+            latest_available_update_id,
+            "latest_available_update_id",
+        )?,
+    }))
+}
+
+fn optional_i32(
+    value: Option<String>,
+    column: &str,
+) -> crate::Result<Option<i32>> {
+    value
+        .map(|value| {
+            value.parse().map_err(|err| {
+                crate::ErrorKind::InputError(format!("Invalid {column}: {err}"))
+                    .into()
+            })
+        })
+        .transpose()
+}
+
 fn parse_uuid(value: Option<String>, column: &str) -> crate::Result<Uuid> {
     let value = required(value, column)?;
 
diff --git a/packages/app-lib/src/state/instances/commands/apply_content_install.rs b/packages/app-lib/src/state/instances/commands/apply_content_install.rs
index 0c780c7e76..bdc7225e94 100644
--- a/packages/app-lib/src/state/instances/commands/apply_content_install.rs
+++ b/packages/app-lib/src/state/instances/commands/apply_content_install.rs
@@ -724,6 +724,31 @@ pub(crate) async fn remove_project(
     Ok(())
 }
 
+pub(crate) async fn content_source_kind_for_project_path(
+    instance_id: &str,
+    project_path: &str,
+    state: &State,
+) -> crate::Result<Option<ContentSourceKind>> {
+    let scope = resolve_content_scope(instance_id, None, state).await?;
+    let Some(file) = content_rows::get_instance_file_by_relative_path(
+        &scope.instance.id,
+        project_path,
+        &state.pool,
+    )
+    .await?
+    else {
+        return Ok(None);
+    };
+    let entries =
+        content_rows::get_content_entries(&scope.content_set_id, &state.pool)
+            .await?;
+
+    Ok(entries.into_iter().find_map(|entry| {
+        (entry.file_id.as_deref() == Some(file.id.as_str()))
+            .then_some(entry.source_kind)
+    }))
+}
+
 pub(crate) async fn list_project_files(
     instance_id: &str,
     state: &State,
diff --git a/packages/app-lib/src/state/instances/commands/apply_content_update.rs b/packages/app-lib/src/state/instances/commands/apply_content_update.rs
index e89d5b5378..f37b785dd8 100644
--- a/packages/app-lib/src/state/instances/commands/apply_content_update.rs
+++ b/packages/app-lib/src/state/instances/commands/apply_content_update.rs
@@ -1,5 +1,6 @@
 use crate::state::instances::{
     ContentEntry, ContentSet, ContentSourceKind, InstanceFile,
+    SharedInstanceRole,
     adapters::sqlite::{content_rows, instance_rows},
 };
 use crate::state::{
@@ -52,6 +53,7 @@ struct InstalledProject {
     relative_path: String,
     project_id: Option<String>,
     version_id: Option<String>,
+    source_kind: ContentSourceKind,
     enabled: bool,
 }
 
@@ -316,6 +318,36 @@ async fn plan_bulk_update(
             })?;
     let installed =
         installed_projects(instance_id, &content_set, state).await?;
+    let updateable_paths = if is_shared_instance_member(instance_id, state).await? {
+        let linked_modpack_paths = installed
+            .iter()
+            .filter(|project| {
+                matches!(
+                    project.source_kind,
+                    ContentSourceKind::ModrinthModpack
+                        | ContentSourceKind::ImportedModpack
+                )
+            })
+            .map(|project| project.relative_path.clone())
+            .collect::<HashSet<_>>();
+
+        updateable_paths
+            .into_iter()
+            .filter(|path| !linked_modpack_paths.contains(path))
+            .collect::<HashSet<_>>()
+    } else {
+        updateable_paths
+    };
+    let updates = updates
+        .into_iter()
+        .filter(|update| updateable_paths.contains(&update.relative_path))
+        .collect::<Vec<_>>();
+    if updates.is_empty() {
+        return Ok(BulkUpdatePlan {
+            project_updates: Vec::new(),
+            dependency_additions: Vec::new(),
+        });
+    }
     let installed_by_project = installed
         .iter()
         .filter_map(|project| {
@@ -457,10 +489,27 @@ fn installed_project_from_row(
         relative_path: file.relative_path.clone(),
         project_id: entry.project_id.clone(),
         version_id: entry.version_id.clone(),
+        source_kind: entry.source_kind,
         enabled: entry.enabled && file.enabled,
     })
 }
 
+async fn is_shared_instance_member(
+    instance_id: &str,
+    state: &State,
+) -> crate::Result<bool> {
+    let Some(metadata) =
+        instance_rows::get_instance_metadata_by_id(instance_id, &state.pool)
+            .await?
+    else {
+        return Ok(false);
+    };
+
+    Ok(metadata
+        .shared_instance
+        .is_some_and(|attachment| attachment.role == SharedInstanceRole::Member))
+}
+
 async fn dependency_closure(
     root_versions: Vec<Version>,
     content_set: &ContentSet,
diff --git a/packages/app-lib/src/state/instances/commands/create_instance.rs b/packages/app-lib/src/state/instances/commands/create_instance.rs
index 7567ec815c..d3ed9d5c92 100644
--- a/packages/app-lib/src/state/instances/commands/create_instance.rs
+++ b/packages/app-lib/src/state/instances/commands/create_instance.rs
@@ -220,9 +220,7 @@ fn content_source_kind(link: &InstanceLink) -> ContentSourceKind {
         InstanceLink::ImportedModpack { .. } => {
             ContentSourceKind::ImportedModpack
         }
-        InstanceLink::SharedInstance { .. } => {
-            ContentSourceKind::SharedInstance
-        }
+        InstanceLink::SharedInstance => ContentSourceKind::SharedInstance,
     }
 }
 
diff --git a/packages/app-lib/src/state/instances/commands/get_instance.rs b/packages/app-lib/src/state/instances/commands/get_instance.rs
index 87be04dfec..cf519ee1ca 100644
--- a/packages/app-lib/src/state/instances/commands/get_instance.rs
+++ b/packages/app-lib/src/state/instances/commands/get_instance.rs
@@ -1,6 +1,6 @@
 use crate::state::instances::{
     ContentSet, Instance, InstanceLaunchOverrides, InstanceLink,
-    adapters::sqlite::instance_rows,
+    SharedInstanceAttachment, adapters::sqlite::instance_rows,
 };
 use serde::{Deserialize, Serialize};
 use sqlx::SqlitePool;
@@ -10,6 +10,7 @@ pub struct InstanceMetadata {
     pub instance: Instance,
     pub applied_content_set: ContentSet,
     pub link: InstanceLink,
+    pub shared_instance: Option<SharedInstanceAttachment>,
     pub groups: Vec<String>,
     pub launch_overrides: InstanceLaunchOverrides,
 }
@@ -61,6 +62,7 @@ impl From<instance_rows::InstanceMetadataRecord> for InstanceMetadata {
             instance: record.instance,
             applied_content_set: record.applied_content_set,
             link: record.link,
+            shared_instance: record.shared_instance,
             groups: record.groups,
             launch_overrides: record.launch_overrides,
         }
diff --git a/packages/app-lib/src/state/instances/commands/list_content.rs b/packages/app-lib/src/state/instances/commands/list_content.rs
index 4272f2990a..7f8302c304 100644
--- a/packages/app-lib/src/state/instances/commands/list_content.rs
+++ b/packages/app-lib/src/state/instances/commands/list_content.rs
@@ -528,6 +528,7 @@ pub(crate) async fn dependencies_to_content_items(
                 has_update: false,
                 update_version_id: None,
                 date_added: None,
+                source_kind: None,
             })
         })
         .collect::<Vec<_>>();
@@ -738,6 +739,7 @@ async fn content_projects_for_scope(
                 size: file.size,
                 metadata: file_metadata_from_entry_or_cache(entry, metadata),
                 project_type,
+                source_kind: entry.map(|entry| entry.source_kind),
             },
         );
     }
@@ -900,6 +902,7 @@ async fn content_files_to_content_items(
                 has_update: file.update_version_id.is_some(),
                 update_version_id: file.update_version_id.clone(),
                 date_added: modification_times[index].clone(),
+                source_kind: file.source_kind,
             }
         })
         .collect::<Vec<_>>();
@@ -1348,12 +1351,7 @@ async fn get_modpack_identifiers(
 }
 
 fn project_type_from_api_name(project_type: &str) -> ProjectType {
-    match project_type {
-        "resourcepack" => ProjectType::ResourcePack,
-        "shader" => ProjectType::ShaderPack,
-        "datapack" => ProjectType::DataPack,
-        _ => ProjectType::Mod,
-    }
+    ProjectType::from_name(project_type).unwrap_or(ProjectType::Mod)
 }
 
 fn sort_content_items(items: &mut [ContentItem]) {
diff --git a/packages/app-lib/src/state/instances/commands/mod.rs b/packages/app-lib/src/state/instances/commands/mod.rs
index bba272e0b0..91161d25af 100644
--- a/packages/app-lib/src/state/instances/commands/mod.rs
+++ b/packages/app-lib/src/state/instances/commands/mod.rs
@@ -41,3 +41,9 @@ mod check_content_updates;
 
 mod apply_content_update;
 pub(crate) use self::apply_content_update::*;
+
+mod shared_instance;
+pub(crate) use self::shared_instance::{
+    attach_shared_instance, clear_shared_instance, mark_shared_instance_stale,
+    set_shared_instance_sync_status,
+};
diff --git a/packages/app-lib/src/state/instances/commands/shared_instance.rs b/packages/app-lib/src/state/instances/commands/shared_instance.rs
new file mode 100644
index 0000000000..731a9f4bd9
--- /dev/null
+++ b/packages/app-lib/src/state/instances/commands/shared_instance.rs
@@ -0,0 +1,161 @@
+use crate::state::instances::adapters::sqlite::{content_rows, instance_rows};
+use crate::state::instances::{
+    ContentSetRemoteRef, ContentSetRemoteRefType, ContentSetSyncProvider,
+    ContentSetSyncState, ContentSetSyncStatus, SharedInstanceAttachment,
+    SharedInstanceRole,
+};
+use chrono::Utc;
+use sqlx::SqlitePool;
+
+pub(crate) async fn attach_shared_instance(
+    instance_id: &str,
+    shared_instance_id: &str,
+    role: SharedInstanceRole,
+    status: ContentSetSyncStatus,
+    applied_version: Option<i32>,
+    latest_version: Option<i32>,
+    pool: &SqlitePool,
+) -> crate::Result<()> {
+    let metadata =
+        instance_rows::get_instance_metadata_by_id(instance_id, pool)
+            .await?
+            .ok_or_else(|| {
+                crate::ErrorKind::InputError("Unknown instance".to_string())
+            })?;
+    let content_set_id = metadata.applied_content_set.id;
+    let attachment = SharedInstanceAttachment {
+        id: shared_instance_id.to_string(),
+        role,
+        status,
+        applied_version,
+        latest_version,
+    };
+    let sync_state =
+        shared_sync_state(&content_set_id, &attachment, Some(Utc::now()));
+
+    let mut tx = pool.begin().await?;
+    instance_rows::set_shared_instance_attachment(
+        instance_id,
+        Some(&attachment),
+        &mut tx,
+    )
+    .await?;
+    content_rows::upsert_content_set_remote_ref(
+        &ContentSetRemoteRef {
+            content_set_id: content_set_id.clone(),
+            ref_type: ContentSetRemoteRefType::SharedContentSet,
+            ref_id: shared_instance_id.to_string(),
+        },
+        &mut tx,
+    )
+    .await?;
+    content_rows::upsert_content_set_sync_state(&sync_state, &mut tx).await?;
+    tx.commit().await?;
+
+    Ok(())
+}
+
+pub(crate) async fn clear_shared_instance(
+    instance_id: &str,
+    pool: &SqlitePool,
+) -> crate::Result<()> {
+    let Some(metadata) =
+        instance_rows::get_instance_metadata_by_id(instance_id, pool).await?
+    else {
+        return Ok(());
+    };
+    let content_set_id = metadata.applied_content_set.id;
+
+    let mut tx = pool.begin().await?;
+    instance_rows::set_shared_instance_attachment(instance_id, None, &mut tx)
+        .await?;
+    content_rows::delete_content_set_remote_ref(
+        &content_set_id,
+        ContentSetRemoteRefType::SharedContentSet,
+        &mut tx,
+    )
+    .await?;
+    content_rows::delete_content_set_sync_state(&content_set_id, &mut tx)
+        .await?;
+    tx.commit().await?;
+
+    Ok(())
+}
+
+pub(crate) async fn set_shared_instance_sync_status(
+    instance_id: &str,
+    status: ContentSetSyncStatus,
+    applied_version: Option<i32>,
+    latest_version: Option<i32>,
+    pool: &SqlitePool,
+) -> crate::Result<()> {
+    let metadata =
+        instance_rows::get_instance_metadata_by_id(instance_id, pool)
+            .await?
+            .ok_or_else(|| {
+                crate::ErrorKind::InputError("Unknown instance".to_string())
+            })?;
+    let Some(mut attachment) = metadata.shared_instance else {
+        return Ok(());
+    };
+
+    attachment.status = status;
+    attachment.applied_version = applied_version;
+    attachment.latest_version = latest_version;
+
+    let sync_state = shared_sync_state(
+        &metadata.applied_content_set.id,
+        &attachment,
+        Some(Utc::now()),
+    );
+    let mut tx = pool.begin().await?;
+    content_rows::upsert_content_set_sync_state(&sync_state, &mut tx).await?;
+    tx.commit().await?;
+
+    Ok(())
+}
+
+pub(crate) async fn mark_shared_instance_stale(
+    instance_id: &str,
+    pool: &SqlitePool,
+) -> crate::Result<()> {
+    let Some(metadata) =
+        instance_rows::get_instance_metadata_by_id(instance_id, pool).await?
+    else {
+        return Ok(());
+    };
+    let Some(attachment) = metadata.shared_instance else {
+        return Ok(());
+    };
+    if attachment.role != SharedInstanceRole::Owner {
+        return Ok(());
+    }
+
+    set_shared_instance_sync_status(
+        instance_id,
+        ContentSetSyncStatus::Stale,
+        attachment.applied_version,
+        attachment.latest_version,
+        pool,
+    )
+    .await
+}
+
+fn shared_sync_state(
+    content_set_id: &str,
+    attachment: &SharedInstanceAttachment,
+    checked_at: Option<chrono::DateTime<Utc>>,
+) -> ContentSetSyncState {
+    ContentSetSyncState {
+        content_set_id: content_set_id.to_string(),
+        provider: ContentSetSyncProvider::SharedInstance,
+        applied_update_id: attachment
+            .applied_version
+            .map(|value| value.to_string()),
+        latest_available_update_id: attachment
+            .latest_version
+            .map(|value| value.to_string()),
+        checked_at,
+        status: attachment.status,
+    }
+}
diff --git a/packages/app-lib/src/state/instances/content.rs b/packages/app-lib/src/state/instances/content.rs
index 507d920927..6a0838ab6e 100644
--- a/packages/app-lib/src/state/instances/content.rs
+++ b/packages/app-lib/src/state/instances/content.rs
@@ -1,3 +1,4 @@
+use super::ContentSourceKind;
 use crate::state::{Project, ProjectType, Version};
 use serde::{Deserialize, Serialize};
 
@@ -15,6 +16,7 @@ pub struct ContentItem {
     pub has_update: bool,
     pub update_version_id: Option<String>,
     pub date_added: Option<String>,
+    pub source_kind: Option<ContentSourceKind>,
 }
 
 #[derive(Debug, Serialize, Deserialize, Clone)]
diff --git a/packages/app-lib/src/state/instances/mod.rs b/packages/app-lib/src/state/instances/mod.rs
index 9426b01d56..416c9ccb4f 100644
--- a/packages/app-lib/src/state/instances/mod.rs
+++ b/packages/app-lib/src/state/instances/mod.rs
@@ -10,6 +10,10 @@ pub use self::commands::{
     AppliedContentSetPatch, CreateInstance, EditInstance,
     InstanceLaunchOverridesPatch, InstanceMetadata,
 };
+pub(crate) use self::commands::{
+    attach_shared_instance, clear_shared_instance, mark_shared_instance_stale,
+    set_shared_instance_sync_status,
+};
 pub(crate) use self::commands::{
     create_instance, edit_instance, get_instance, get_instances_metadata,
     list_instances, refresh_all_instances, remove_instance,
diff --git a/packages/app-lib/src/state/instances/model/link.rs b/packages/app-lib/src/state/instances/model/link.rs
index e85ed08600..2d82122a35 100644
--- a/packages/app-lib/src/state/instances/model/link.rs
+++ b/packages/app-lib/src/state/instances/model/link.rs
@@ -1,6 +1,8 @@
 use serde::{Deserialize, Serialize};
 use uuid::Uuid;
 
+use super::ContentSetSyncStatus;
+
 #[derive(Clone, Debug, Serialize, Deserialize)]
 #[serde(rename_all = "snake_case")]
 pub enum InstanceLink {
@@ -32,7 +34,38 @@ pub enum InstanceLink {
         version_number: Option<String>,
         filename: Option<String>,
     },
-    SharedInstance {
-        shared_instance_id: Uuid,
-    },
+    SharedInstance,
+}
+
+#[derive(Clone, Copy, Debug, Eq, PartialEq, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum SharedInstanceRole {
+    Owner,
+    Member,
+}
+
+impl SharedInstanceRole {
+    pub fn as_str(self) -> &'static str {
+        match self {
+            Self::Owner => "owner",
+            Self::Member => "member",
+        }
+    }
+
+    pub fn from_str(value: &str) -> crate::Result<Self> {
+        match value {
+            "owner" => Ok(Self::Owner),
+            "member" => Ok(Self::Member),
+            other => Err(super::unknown_value("shared instance role", other)),
+        }
+    }
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct SharedInstanceAttachment {
+    pub id: String,
+    pub role: SharedInstanceRole,
+    pub status: ContentSetSyncStatus,
+    pub applied_version: Option<i32>,
+    pub latest_version: Option<i32>,
 }
diff --git a/packages/app-lib/src/state/instances/watcher.rs b/packages/app-lib/src/state/instances/watcher.rs
index 08647a5dc3..4a5d759247 100644
--- a/packages/app-lib/src/state/instances/watcher.rs
+++ b/packages/app-lib/src/state/instances/watcher.rs
@@ -138,7 +138,25 @@ pub async fn init_watcher() -> crate::Result<FileWatcher> {
                                 };
                                 if let Some(event) = event {
                                     let emit_instance_id = instance_id.clone();
+                                    let mark_shared_stale = matches!(
+                                        &event,
+                                        InstancePayloadType::Synced
+                                    );
                                     tokio::spawn(async move {
+                                        if mark_shared_stale
+                                            && let Ok(state) =
+                                                State::get().await
+                                            && let Err(error) =
+                                                super::commands::mark_shared_instance_stale(
+                                                    &emit_instance_id,
+                                                    &state.pool,
+                                                )
+                                                .await
+                                        {
+                                            tracing::error!(
+                                                "Failed to mark shared instance stale after filesystem sync: {error}"
+                                            );
+                                        }
                                         let _ = emit_instance(
                                             &emit_instance_id,
                                             event,
diff --git a/packages/ui/src/components/base/Admonition.vue b/packages/ui/src/components/base/Admonition.vue
index 38c09af896..da84a6c59c 100644
--- a/packages/ui/src/components/base/Admonition.vue
+++ b/packages/ui/src/components/base/Admonition.vue
@@ -9,25 +9,47 @@
 		<slot name="icon" :icon-class="['h-6 w-6 flex-none', iconClasses[type]]">
 			<component :is="getSeverityIcon(type)" :class="['h-6 w-6 flex-none', iconClasses[type]]" />
 		</slot>
-		<div class="col-start-2 flex min-w-0 flex-1 flex-col gap-2">
+		<div
+			class="col-start-2 min-w-0"
+			:class="
+				inlineActions && !showActionsUnderneath && $slots.actions
+					? 'flex flex-wrap items-start gap-x-4 gap-y-3'
+					: 'flex flex-1 flex-col gap-2'
+			"
+		>
 			<div
-				v-if="header || $slots.header || normalizedTimestamp"
-				class="flex flex-wrap items-center gap-2 text-lg font-semibold leading-6"
+				class="flex min-w-0 flex-1 flex-col gap-2"
+				:class="
+					inlineActions && !showActionsUnderneath && $slots.actions
+						? 'admonition-inline-content'
+						: ''
+				"
 			>
-				<slot name="header">{{ header }}</slot>
-				<span
-					v-if="normalizedTimestamp"
-					v-tooltip="timestampTooltip"
-					class="flex items-center gap-1.5 text-base font-medium leading-normal text-secondary"
+				<div
+					v-if="header || $slots.header || normalizedTimestamp"
+					class="flex flex-wrap items-center gap-2 text-lg font-semibold leading-6"
 				>
-					<ClockIcon class="size-4" />
-					{{ relativeTimeLabel }}
-				</span>
+					<slot name="header">{{ header }}</slot>
+					<span
+						v-if="normalizedTimestamp"
+						v-tooltip="timestampTooltip"
+						class="flex items-center gap-1.5 text-base font-medium leading-normal text-secondary"
+					>
+						<ClockIcon class="size-4" />
+						{{ relativeTimeLabel }}
+					</span>
+				</div>
+				<div class="font-normal text-contrast/85 leading-tight">
+					<slot>{{ body }}</slot>
+				</div>
 			</div>
-			<div class="font-normal text-contrast/85 leading-tight">
-				<slot>{{ body }}</slot>
+			<div
+				v-if="inlineActions && !showActionsUnderneath && $slots.actions"
+				class="ml-auto flex shrink-0 items-center justify-end self-center"
+			>
+				<slot name="actions" />
 			</div>
-			<div v-if="showActionsUnderneath || $slots.actions" class="mt-2">
+			<div v-else-if="showActionsUnderneath || $slots.actions" class="mt-2">
 				<slot name="actions" />
 			</div>
 		</div>
@@ -83,6 +105,7 @@ const props = withDefaults(
 		type?: 'info' | 'warning' | 'critical' | 'success' | 'moderation' | 'circle-warning'
 		header?: string
 		body?: string
+		inlineActions?: boolean
 		showActionsUnderneath?: boolean
 		dismissible?: boolean
 		progress?: number
@@ -95,6 +118,7 @@ const props = withDefaults(
 		type: 'info',
 		header: '',
 		body: '',
+		inlineActions: false,
 		showActionsUnderneath: false,
 		dismissible: false,
 		progress: undefined,
@@ -185,6 +209,10 @@ const progressFillClasses = {
 </script>
 
 <style scoped>
+.admonition-inline-content {
+	min-width: min(100%, 16rem);
+}
+
 .admonition-progress--waiting {
 	animation: admonition-progress-waiting 1s linear infinite;
 	position: relative;
diff --git a/packages/ui/src/components/index.ts b/packages/ui/src/components/index.ts
index 98a16429fc..6d99b45fcb 100644
--- a/packages/ui/src/components/index.ts
+++ b/packages/ui/src/components/index.ts
@@ -14,6 +14,7 @@ export * from './project'
 export * from './search'
 export * from './servers'
 export * from './settings'
+export * from './sharing'
 export * from './skin'
 export * from './user'
 export * from './version'
diff --git a/packages/ui/src/components/notifications/NotificationToast.vue b/packages/ui/src/components/notifications/NotificationToast.vue
index ee3bad90c1..ed4710da8e 100644
--- a/packages/ui/src/components/notifications/NotificationToast.vue
+++ b/packages/ui/src/components/notifications/NotificationToast.vue
@@ -35,20 +35,8 @@
 								>.
 							</template>
 							<template v-else>
-								<span class="inline-flex max-w-full items-center gap-[5px] align-[-4px]">
-									<Avatar
-										:src="entityIconUrl"
-										:alt="entityLabel"
-										size="24px"
-										no-shadow
-										raised
-										:tint-by="entityLabel"
-										class="!rounded-[7px]"
-									/>
-									<span class="min-w-0 truncate font-semibold text-contrast">{{
-										entityLabel
-									}}</span> </span
-								>.
+								<span class="font-semibold text-contrast">{{ entityLabel }}</span>
+								<span> instance.</span>
 							</template>
 						</template>
 					</p>
@@ -247,7 +235,7 @@ const inviteActionText = computed(() => {
 		return 'invited you to manage the server'
 	}
 
-	return 'invited you to play the instance'
+	return 'invited you to'
 })
 
 const resolvedStatusText = computed(() => {
diff --git a/packages/ui/src/components/sharing/index.ts b/packages/ui/src/components/sharing/index.ts
new file mode 100644
index 0000000000..9404102e49
--- /dev/null
+++ b/packages/ui/src/components/sharing/index.ts
@@ -0,0 +1,2 @@
+export { default as InvitePlayersModal } from './invite-players-modal/index.vue'
+export * from './invite-players-modal/types'
diff --git a/packages/ui/src/components/sharing/invite-players-modal/index.vue b/packages/ui/src/components/sharing/invite-players-modal/index.vue
new file mode 100644
index 0000000000..57732f8cf8
--- /dev/null
+++ b/packages/ui/src/components/sharing/invite-players-modal/index.vue
@@ -0,0 +1,527 @@
+<template>
+	<NewModal
+		ref="modal"
+		:header="header"
+		width="min(34rem, calc(100vw - 2rem))"
+		max-width="34rem"
+		no-padding
+	>
+		<div class="flex max-h-[calc(100vh-8rem)] min-h-0 flex-col">
+			<div class="border-0 border-b border-solid border-surface-5 p-6">
+				<div class="flex items-start gap-2">
+					<Combobox
+						:key="searchInputKey"
+						:model-value="undefined"
+						:options="searchOptions"
+						:search-value="searchTarget"
+						:search-placeholder="searchPlaceholderLabel"
+						:placeholder="searchPlaceholderLabel"
+						:no-options-message="searchLookupMessage"
+						:min-search-length-to-open="searchMinimumLength"
+						:disable-search-filter="usesRemoteSearch"
+						class="min-w-0 flex-1"
+						searchable
+						show-search-icon
+						:show-chevron="false"
+						search-type="search"
+						search-name="modrinth-player-invite-search"
+						search-inputmode="search"
+						search-autocomplete="new-password"
+						search-autocorrect="off"
+						search-autocapitalize="none"
+						:search-spellcheck="false"
+						:search-input-attrs="passwordManagerIgnoreAttrs"
+						@search-input="handleSearchInput"
+						@select="handleSearchSelect"
+					>
+						<template #option="{ item, isSelected }">
+							<div class="flex min-w-0 items-center gap-2">
+								<Avatar
+									:src="findSearchUser(item.value)?.avatarUrl"
+									:alt="formatMessage(messages.avatarAlt, { username: item.label })"
+									:tint-by="item.label"
+									size="1.5rem"
+									circle
+									no-shadow
+								/>
+								<span
+									class="min-w-0 truncate font-semibold"
+									:class="isSelected ? 'text-contrast' : 'text-primary'"
+								>
+									{{ item.label }}
+								</span>
+							</div>
+						</template>
+					</Combobox>
+					<ButtonStyled color="brand">
+						<button
+							v-tooltip="searchInviteTooltip"
+							class="shrink-0"
+							:disabled="!canInviteSearchTarget"
+							@click="inviteSearchTarget"
+						>
+							<PlusIcon aria-hidden="true" />
+							{{ addButtonLabel }}
+						</button>
+					</ButtonStyled>
+				</div>
+			</div>
+
+			<div class="min-h-[11rem] overflow-y-auto bg-surface-2 px-6 py-4">
+				<div class="mb-2 text-base font-semibold text-primary">
+					{{ friendsHeading }}
+				</div>
+				<div
+					v-if="friends.length === 0"
+					class="flex min-h-32 items-center justify-center text-secondary"
+				>
+					{{ emptyFriendsLabel }}
+				</div>
+				<div v-else class="-mx-6 flex flex-col">
+					<InvitePlayersModalUserRow
+						v-for="friend in sortedFriends"
+						:key="friend.id"
+						:user="friend"
+						:avatar-alt="formatMessage(messages.avatarAlt, { username: friend.username })"
+						:added-label="addedButtonLabel"
+						:cancel-label="cancelButtonLabel"
+						:invite-label="inviteButtonLabel"
+						:requested-label="requestedButtonLabel"
+						:requested-tooltip="requestedTooltip(friend.username)"
+						:user-profile-link="userProfileLink"
+						@invite="inviteFriend"
+						@cancel="cancelInvite"
+					/>
+				</div>
+			</div>
+
+			<div v-if="link" class="border-0 border-t border-solid border-surface-5 p-6">
+				<div class="flex flex-col gap-2">
+					<div class="text-base font-semibold text-contrast">
+						{{ inviteLinkHeading }}
+					</div>
+					<button
+						type="button"
+						class="flex h-10 w-full cursor-pointer items-center justify-between gap-3 rounded-[14px] border-none bg-surface-2 px-4 text-left transition-all hover:brightness-110 active:scale-[0.98]"
+						@click="copyInviteLink"
+					>
+						<span class="min-w-0 truncate text-base font-semibold text-primary">
+							{{ link }}
+						</span>
+						<ClipboardCopyIcon class="size-5 shrink-0 text-secondary" aria-hidden="true" />
+					</button>
+					<p class="m-0 text-base text-primary">
+						{{ inviteLinkDescription }}
+					</p>
+				</div>
+			</div>
+		</div>
+	</NewModal>
+</template>
+
+<script setup lang="ts">
+import { ClipboardCopyIcon, PlusIcon } from '@modrinth/assets'
+import { useDebounceFn } from '@vueuse/core'
+import { computed, ref } from 'vue'
+
+import { defineMessages, useVIntl } from '../../../composables/i18n'
+import { injectNotificationManager } from '../../../providers'
+import Avatar from '../../base/Avatar.vue'
+import ButtonStyled from '../../base/ButtonStyled.vue'
+import Combobox, { type ComboboxOption } from '../../base/Combobox.vue'
+import NewModal from '../../modal/NewModal.vue'
+import InvitePlayersModalUserRow from './invite-players-modal-user-row.vue'
+import type {
+	InvitePlayersInvitePayload,
+	InvitePlayersSearchUser,
+	InvitePlayersUser,
+	InvitePlayersUserProfileLink,
+	InvitePlayersUserStatus,
+} from './types'
+
+const props = withDefaults(
+	defineProps<{
+		header?: string
+		friends?: InvitePlayersUser[]
+		suggestions?: InvitePlayersSearchUser[]
+		searchUsers?: (query: string) => Promise<InvitePlayersSearchUser[]>
+		link?: string
+		linkDescription?: string
+		friendsLabel?: string
+		searchPlaceholder?: string
+		addLabel?: string
+		inviteLabel?: string
+		addedLabel?: string
+		cancelLabel?: string
+		requestedLabel?: string
+		emptyFriendsLabel?: string
+		canInvite?: boolean
+		inviteDisabledMessage?: string
+		userProfileLink?: (username: string) => InvitePlayersUserProfileLink
+	}>(),
+	{
+		header: 'Share instance',
+		friends: () => [],
+		suggestions: () => [],
+		canInvite: true,
+	},
+)
+
+const emit = defineEmits<{
+	invite: [payload: InvitePlayersInvitePayload]
+	cancel: [user: InvitePlayersUser]
+	'copy-link': [link: string]
+}>()
+
+const { formatMessage } = useVIntl()
+const notificationManager = injectNotificationManager(null)
+const modal = ref<InstanceType<typeof NewModal> | null>(null)
+const searchTarget = ref('')
+const searchInputKey = ref(0)
+const selectedSearchUser = ref<InvitePlayersSearchUser | null>(null)
+const remoteSearchUsers = ref<InvitePlayersSearchUser[]>([])
+const searchLookupStatus = ref<'idle' | 'loading' | 'loaded'>('idle')
+const searchLookupRequestId = ref(0)
+const searchMinimumLength = 1
+const passwordManagerIgnoreAttrs = {
+	'data-1p-ignore': 'true',
+	'data-bwignore': 'true',
+	'data-form-type': 'other',
+	'data-lpignore': 'true',
+	'data-protonpass-ignore': 'true',
+}
+
+const messages = defineMessages({
+	friendsHeading: {
+		id: 'sharing.invite-players-modal.friends-heading',
+		defaultMessage: 'Your friends - {count}',
+	},
+	searchPlaceholder: {
+		id: 'sharing.invite-players-modal.search-placeholder',
+		defaultMessage: 'Enter Modrinth username',
+	},
+	addButton: {
+		id: 'sharing.invite-players-modal.add',
+		defaultMessage: 'Add',
+	},
+	inviteButton: {
+		id: 'sharing.invite-players-modal.invite',
+		defaultMessage: 'Invite',
+	},
+	addedButton: {
+		id: 'sharing.invite-players-modal.added',
+		defaultMessage: 'Added',
+	},
+	cancelButton: {
+		id: 'sharing.invite-players-modal.cancel',
+		defaultMessage: 'Cancel',
+	},
+	requestedButton: {
+		id: 'sharing.invite-players-modal.requested',
+		defaultMessage: 'Request sent',
+	},
+	requestedTooltip: {
+		id: 'sharing.invite-players-modal.requested-tooltip',
+		defaultMessage: '{username} needs to accept your friend request first',
+	},
+	noFriends: {
+		id: 'sharing.invite-players-modal.no-friends',
+		defaultMessage: 'No friends found.',
+	},
+	noSearchResults: {
+		id: 'sharing.invite-players-modal.no-search-results',
+		defaultMessage: 'No matching users found.',
+	},
+	searching: {
+		id: 'sharing.invite-players-modal.searching',
+		defaultMessage: 'Searching...',
+	},
+	alreadyInvited: {
+		id: 'sharing.invite-players-modal.already-invited',
+		defaultMessage: 'This user has already been invited.',
+	},
+	inviteLinkHeading: {
+		id: 'sharing.invite-players-modal.invite-link-heading',
+		defaultMessage: 'Or use an invite link',
+	},
+	inviteLinkDescription: {
+		id: 'sharing.invite-players-modal.invite-link-description',
+		defaultMessage:
+			'This link invites your friends as players and automatically shares all required files!',
+	},
+	linkCopiedTitle: {
+		id: 'sharing.invite-players-modal.link-copied-title',
+		defaultMessage: 'Link copied',
+	},
+	linkCopiedText: {
+		id: 'sharing.invite-players-modal.link-copied-text',
+		defaultMessage: 'The invite link has been copied to your clipboard.',
+	},
+	linkCopyFailedTitle: {
+		id: 'sharing.invite-players-modal.link-copy-failed-title',
+		defaultMessage: 'Failed to copy link',
+	},
+	avatarAlt: {
+		id: 'sharing.invite-players-modal.avatar-alt',
+		defaultMessage: "{username}'s avatar",
+	},
+})
+
+const normalizedSearchTarget = computed(() => searchTarget.value.trim())
+const usesRemoteSearch = computed(() => !!props.searchUsers)
+const friendsHeading = computed(
+	() =>
+		props.friendsLabel ??
+		formatMessage(messages.friendsHeading, {
+			count: props.friends.length,
+		}),
+)
+const searchPlaceholderLabel = computed(
+	() => props.searchPlaceholder ?? formatMessage(messages.searchPlaceholder),
+)
+const addButtonLabel = computed(() => props.addLabel ?? formatMessage(messages.addButton))
+const inviteButtonLabel = computed(() => props.inviteLabel ?? formatMessage(messages.inviteButton))
+const addedButtonLabel = computed(() => props.addedLabel ?? formatMessage(messages.addedButton))
+const cancelButtonLabel = computed(() => props.cancelLabel ?? formatMessage(messages.cancelButton))
+const requestedButtonLabel = computed(
+	() => props.requestedLabel ?? formatMessage(messages.requestedButton),
+)
+const requestedTooltip = (username: string) =>
+	formatMessage(messages.requestedTooltip, {
+		username,
+	})
+const emptyFriendsLabel = computed(
+	() => props.emptyFriendsLabel ?? formatMessage(messages.noFriends),
+)
+const inviteLinkHeading = computed(() => formatMessage(messages.inviteLinkHeading))
+const inviteLinkDescription = computed(
+	() => props.linkDescription ?? formatMessage(messages.inviteLinkDescription),
+)
+const inviteDisabledMessage = computed(
+	() => props.inviteDisabledMessage ?? formatMessage(messages.alreadyInvited),
+)
+const searchLookupMessage = computed(() =>
+	usesRemoteSearch.value && searchLookupStatus.value !== 'loaded'
+		? formatMessage(messages.searching)
+		: formatMessage(messages.noSearchResults),
+)
+const searchableUsers = computed(() => {
+	const users = new Map<string, InvitePlayersSearchUser>()
+
+	for (const user of [...remoteSearchUsers.value, ...props.suggestions]) {
+		users.set(user.id.toLowerCase(), user)
+		users.set(user.username.toLowerCase(), user)
+		if (user.email) users.set(user.email.toLowerCase(), user)
+	}
+
+	return [...new Set(users.values())]
+})
+const searchOptions = computed<ComboboxOption<string>[]>(() =>
+	searchableUsers.value.map((user) => ({
+		value: user.username,
+		label: user.username,
+		searchTerms: [user.username, user.id, user.email].filter(Boolean) as string[],
+	})),
+)
+const sortedFriends = computed(() =>
+	props.friends
+		.map((friend, index) => ({ friend, index }))
+		.sort((a, b) => {
+			const statusSort = friendStatusSort(a.friend) - friendStatusSort(b.friend)
+			return statusSort || a.index - b.index
+		})
+		.map(({ friend }) => friend),
+)
+const matchedSearchUser = computed(() => {
+	if (
+		selectedSearchUser.value &&
+		normalizeInviteKey(selectedSearchUser.value.username) ===
+			normalizeInviteKey(normalizedSearchTarget.value)
+	) {
+		return selectedSearchUser.value
+	}
+
+	return findSearchUser(normalizedSearchTarget.value)
+})
+const invitedUserKeys = computed(() => {
+	const keys = new Set<string>()
+
+	for (const friend of props.friends) {
+		if (friendStatus(friend) === 'available') continue
+		keys.add(normalizeInviteKey(friend.id))
+		keys.add(normalizeInviteKey(friend.username))
+	}
+
+	return keys
+})
+const searchTargetAlreadyInvited = computed(() => {
+	const user = matchedSearchUser.value
+	if (!user) return false
+
+	return (
+		invitedUserKeys.value.has(normalizeInviteKey(user.id)) ||
+		invitedUserKeys.value.has(normalizeInviteKey(user.username))
+	)
+})
+const canInviteSearchTarget = computed(
+	() =>
+		props.canInvite &&
+		normalizedSearchTarget.value.length >= searchMinimumLength &&
+		!!matchedSearchUser.value &&
+		!searchTargetAlreadyInvited.value &&
+		(!usesRemoteSearch.value ||
+			searchLookupStatus.value === 'loaded' ||
+			!!selectedSearchUser.value),
+)
+const searchInviteTooltip = computed(() => {
+	if (!props.canInvite) return inviteDisabledMessage.value
+	if (searchTargetAlreadyInvited.value) return formatMessage(messages.alreadyInvited)
+	return undefined
+})
+
+const searchTargetUsers = useDebounceFn(async (query: string, requestId: number) => {
+	const searchUsers = props.searchUsers
+	if (!searchUsers) return
+
+	try {
+		const users = await searchUsers(query)
+		if (requestId !== searchLookupRequestId.value || query !== normalizedSearchTarget.value) return
+
+		remoteSearchUsers.value = users
+	} catch {
+		if (requestId !== searchLookupRequestId.value || query !== normalizedSearchTarget.value) return
+
+		remoteSearchUsers.value = []
+	} finally {
+		if (requestId === searchLookupRequestId.value && query === normalizedSearchTarget.value) {
+			searchLookupStatus.value = 'loaded'
+		}
+	}
+}, 250)
+
+function friendStatus(friend: InvitePlayersUser): InvitePlayersUserStatus {
+	return friend.status ?? 'available'
+}
+
+function friendStatusSort(friend: InvitePlayersUser) {
+	switch (friendStatus(friend)) {
+		case 'available':
+			return 0
+		case 'requested':
+			return 1
+		case 'pending':
+			return 2
+		case 'added':
+			return 3
+	}
+}
+
+function normalizeInviteKey(value: string) {
+	return value.trim().toLowerCase()
+}
+
+function findSearchUser(value: string) {
+	const normalizedValue = normalizeInviteKey(value)
+	return searchableUsers.value.find(
+		(user) =>
+			normalizeInviteKey(user.username) === normalizedValue ||
+			normalizeInviteKey(user.id) === normalizedValue ||
+			(!!user.email && normalizeInviteKey(user.email) === normalizedValue),
+	)
+}
+
+function handleSearchInput(value: string) {
+	searchTarget.value = value
+	selectedSearchUser.value = null
+	remoteSearchUsers.value = []
+	searchLookupRequestId.value += 1
+
+	if (normalizedSearchTarget.value.length < searchMinimumLength) {
+		searchLookupStatus.value = 'idle'
+		return
+	}
+
+	if (!usesRemoteSearch.value) {
+		searchLookupStatus.value = 'loaded'
+		return
+	}
+
+	searchLookupStatus.value = 'loading'
+	void searchTargetUsers(normalizedSearchTarget.value, searchLookupRequestId.value)
+}
+
+function handleSearchSelect(option: ComboboxOption<string>) {
+	searchTarget.value = option.value
+	selectedSearchUser.value = findSearchUser(option.value) ?? null
+	searchLookupStatus.value = 'loaded'
+}
+
+function resetSearch() {
+	searchTarget.value = ''
+	searchInputKey.value += 1
+	selectedSearchUser.value = null
+	remoteSearchUsers.value = []
+	searchLookupStatus.value = 'idle'
+	searchLookupRequestId.value += 1
+}
+
+function inviteSearchTarget() {
+	if (!canInviteSearchTarget.value) return
+	const user = matchedSearchUser.value
+	if (!user) return
+
+	emit('invite', {
+		user: {
+			id: user.id,
+			username: user.username,
+			avatarUrl: user.avatarUrl,
+		},
+		source: 'search',
+	})
+	resetSearch()
+}
+
+function inviteFriend(friend: InvitePlayersUser) {
+	emit('invite', {
+		user: friend,
+		source: 'friend',
+	})
+}
+
+function cancelInvite(friend: InvitePlayersUser) {
+	emit('cancel', friend)
+}
+
+async function copyInviteLink() {
+	if (!props.link) return
+
+	emit('copy-link', props.link)
+
+	try {
+		await navigator.clipboard.writeText(props.link)
+		notificationManager?.addNotification({
+			type: 'success',
+			title: formatMessage(messages.linkCopiedTitle),
+			text: formatMessage(messages.linkCopiedText),
+		})
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error)
+		notificationManager?.addNotification({
+			type: 'error',
+			title: formatMessage(messages.linkCopyFailedTitle),
+			text: message,
+		})
+	}
+}
+
+function show(event?: MouseEvent) {
+	resetSearch()
+	modal.value?.show(event)
+}
+
+function hide() {
+	modal.value?.hide()
+}
+
+defineExpose({ show, hide })
+</script>
diff --git a/packages/ui/src/components/sharing/invite-players-modal/invite-players-modal-user-row.vue b/packages/ui/src/components/sharing/invite-players-modal/invite-players-modal-user-row.vue
new file mode 100644
index 0000000000..3ef37503c6
--- /dev/null
+++ b/packages/ui/src/components/sharing/invite-players-modal/invite-players-modal-user-row.vue
@@ -0,0 +1,101 @@
+<template>
+	<div
+		class="flex h-10 items-center justify-between gap-3 px-6 transition-colors hover:bg-surface-3"
+	>
+		<div class="flex min-w-0 items-center gap-1.5">
+			<AutoLink
+				v-tooltip="user.username"
+				:to="profileLink"
+				:target="profileTarget"
+				class="inline-flex min-w-0 items-center gap-1.5"
+				:class="profileLink ? 'text-primary hover:underline' : ''"
+			>
+				<span class="relative flex shrink-0">
+					<Avatar
+						:src="user.avatarUrl"
+						:alt="avatarAlt"
+						:tint-by="user.username"
+						size="1.5rem"
+						circle
+						no-shadow
+					/>
+					<span
+						v-if="user.online"
+						class="absolute bottom-0 right-0 size-[7px] rounded-full border border-solid border-surface-2 bg-brand"
+					/>
+				</span>
+				<span class="min-w-0 truncate text-base font-medium">
+					{{ user.username }}
+				</span>
+			</AutoLink>
+		</div>
+
+		<ButtonStyled v-if="status === 'added'" type="standard" color-fill="none">
+			<button disabled>
+				<CheckIcon aria-hidden="true" />
+				{{ addedLabel }}
+			</button>
+		</ButtonStyled>
+		<ButtonStyled v-else-if="status === 'pending'" type="outlined">
+			<button @click="$emit('cancel', user)">
+				{{ cancelLabel }}
+			</button>
+		</ButtonStyled>
+		<span v-else-if="status === 'requested'" v-tooltip="requestedTooltip" class="inline-flex">
+			<ButtonStyled type="standard" color-fill="none">
+				<button disabled>
+					{{ requestedLabel }}
+				</button>
+			</ButtonStyled>
+		</span>
+		<ButtonStyled v-else color-fill="none">
+			<button @click="$emit('invite', user)">
+				{{ inviteLabel }}
+			</button>
+		</ButtonStyled>
+	</div>
+</template>
+
+<script setup lang="ts">
+import { CheckIcon } from '@modrinth/assets'
+import { computed } from 'vue'
+
+import AutoLink from '../../base/AutoLink.vue'
+import Avatar from '../../base/Avatar.vue'
+import ButtonStyled from '../../base/ButtonStyled.vue'
+import type { InvitePlayersUser, InvitePlayersUserProfileLink } from './types'
+
+const props = withDefaults(
+	defineProps<{
+		user: InvitePlayersUser
+		avatarAlt: string
+		addedLabel: string
+		cancelLabel: string
+		inviteLabel: string
+		requestedLabel: string
+		requestedTooltip: string
+		userProfileLink?: (username: string) => InvitePlayersUserProfileLink
+	}>(),
+	{
+		userProfileLink: undefined,
+	},
+)
+
+defineEmits<{
+	invite: [user: InvitePlayersUser]
+	cancel: [user: InvitePlayersUser]
+}>()
+
+const status = computed(() => props.user.status ?? 'available')
+const profileLink = computed(() => getUserProfileLink(props.user.username))
+const profileTarget = computed(() =>
+	typeof profileLink.value === 'string' && profileLink.value.startsWith('http')
+		? '_blank'
+		: undefined,
+)
+
+function getUserProfileLink(username: string): InvitePlayersUserProfileLink {
+	if (!username || username.includes('@')) return undefined
+	return props.userProfileLink?.(username) ?? `/user/${encodeURIComponent(username)}`
+}
+</script>
diff --git a/packages/ui/src/components/sharing/invite-players-modal/types.ts b/packages/ui/src/components/sharing/invite-players-modal/types.ts
new file mode 100644
index 0000000000..ae60cd2be6
--- /dev/null
+++ b/packages/ui/src/components/sharing/invite-players-modal/types.ts
@@ -0,0 +1,27 @@
+import type { RouteLocationRaw } from 'vue-router'
+
+export type InvitePlayersUserStatus = 'available' | 'requested' | 'pending' | 'added'
+export type InvitePlayersUserProfileLink =
+	| RouteLocationRaw
+	| (() => void | Promise<void>)
+	| undefined
+
+export interface InvitePlayersUser {
+	id: string
+	username: string
+	avatarUrl?: string | null
+	status?: InvitePlayersUserStatus
+	online?: boolean
+}
+
+export interface InvitePlayersSearchUser {
+	id: string
+	username: string
+	avatarUrl?: string | null
+	email?: string
+}
+
+export interface InvitePlayersInvitePayload {
+	user: InvitePlayersUser
+	source: 'friend' | 'search'
+}
diff --git a/packages/ui/src/layouts/shared/content-tab/components/ContentCardTable.vue b/packages/ui/src/layouts/shared/content-tab/components/ContentCardTable.vue
index 1da88cf502..f61dc66b1c 100644
--- a/packages/ui/src/layouts/shared/content-tab/components/ContentCardTable.vue
+++ b/packages/ui/src/layouts/shared/content-tab/components/ContentCardTable.vue
@@ -67,7 +67,8 @@ const hasEnabledListener = computed(
 const hasAnyActions = computed(() => {
 	// Check if there are listeners for actions
 	const hasListeners =
-		(hasDeleteListener.value && !props.hideDelete) ||
+		(hasDeleteListener.value &&
+			props.items.some((item) => !props.hideDelete && !item.hideDelete)) ||
 		hasUpdateListener.value ||
 		hasSwitchVersionListener.value ||
 		hasEnabledListener.value
@@ -273,7 +274,7 @@ function handleSort(column: ContentCardTableSortColumn) {
 					:toggle-disabled="item.toggleDisabled"
 					:toggle-disabled-tooltip="item.toggleDisabledTooltip"
 					:show-checkbox="showSelection"
-					:hide-delete="hideDelete"
+					:hide-delete="hideDelete || item.hideDelete"
 					:hide-actions="!hasAnyActions"
 					:selected="isItemSelected(item.id)"
 					:class="[
@@ -326,13 +327,14 @@ function handleSort(column: ContentCardTableSortColumn) {
 				:has-update="item.hasUpdate"
 				:is-client-only="item.isClientOnly"
 				:client-warning="item.clientWarning"
+				:hide-switch-version="item.hideSwitchVersion"
 				:overflow-options="item.overflowOptions"
 				:disabled="item.disabled"
 				:disabled-tooltip="item.disabledTooltip"
 				:toggle-disabled="item.toggleDisabled"
 				:toggle-disabled-tooltip="item.toggleDisabledTooltip"
 				:show-checkbox="showSelection"
-				:hide-delete="hideDelete"
+				:hide-delete="hideDelete || item.hideDelete"
 				:hide-actions="!hasAnyActions"
 				:selected="isItemSelected(item.id)"
 				:class="[
diff --git a/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmDeletionModal.vue b/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmDeletionModal.vue
index d3b6118eff..72b1e2d089 100644
--- a/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmDeletionModal.vue
+++ b/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmDeletionModal.vue
@@ -11,8 +11,8 @@
 		:on-hide="() => backupCreator?.cancelBackup()"
 	>
 		<div class="flex flex-col gap-6">
-			<Admonition type="warning" :header="formatMessage(messages.admonitionHeader)">
-				{{ formatMessage(messages.admonitionBody) }}
+			<Admonition type="warning" :header="admonitionHeader">
+				{{ admonitionBody }}
 			</Admonition>
 			<InlineBackupCreator
 				ref="backupCreator"
@@ -36,12 +36,7 @@
 						@click="confirm"
 					>
 						<TrashIcon />
-						{{
-							formatMessage(messages.deleteButton, {
-								count: visibleCount,
-								itemType: formatContentTypeSentence(formatMessage, visibleItemType, visibleCount),
-							})
-						}}
+						{{ deleteButtonLabel }}
 					</button>
 				</ButtonStyled>
 			</div>
@@ -51,7 +46,7 @@
 
 <script setup lang="ts">
 import { TrashIcon, XIcon } from '@modrinth/assets'
-import { nextTick, ref } from 'vue'
+import { computed, nextTick, ref } from 'vue'
 
 import Admonition from '#ui/components/base/Admonition.vue'
 import ButtonStyled from '#ui/components/base/ButtonStyled.vue'
@@ -81,18 +76,42 @@ const messages = defineMessages({
 		id: 'content.confirm-deletion.delete-button',
 		defaultMessage: 'Delete {count, number} {itemType}',
 	},
+	sharedAdmonitionHeader: {
+		id: 'content.confirm-deletion.shared-instance.admonition-header',
+		defaultMessage: 'This is part of the shared instance',
+	},
+	sharedSingleBody: {
+		id: 'content.confirm-deletion.shared-instance.single-body',
+		defaultMessage:
+			'Deleting it only changes your local copy. Future shared instance updates may restore or change it again.',
+	},
+	sharedBulkBody: {
+		id: 'content.confirm-deletion.shared-instance.bulk-body',
+		defaultMessage:
+			'Some selected projects are part of the shared instance. Deleting them only changes your local copy, and future shared instance updates may restore or change them again.',
+	},
+	sharedDeleteButton: {
+		id: 'content.confirm-deletion.shared-instance.delete-button',
+		defaultMessage: 'Delete anyway',
+	},
+	sharedDeleteManyButton: {
+		id: 'content.confirm-deletion.shared-instance.delete-many-button',
+		defaultMessage: 'Delete {count, number} {itemType} anyway',
+	},
 })
 
 const props = withDefaults(
 	defineProps<{
 		count: number
 		itemType: string
+		mode?: 'default' | 'shared-instance'
 		variant?: 'instance' | 'server'
 		backupTip?: string
 		actionDisabled?: boolean
 		actionDisabledTooltip?: string
 	}>(),
 	{
+		mode: 'default',
 		variant: 'instance',
 		backupTip: undefined,
 		actionDisabled: false,
@@ -109,11 +128,51 @@ const backupCreator = ref<InstanceType<typeof InlineBackupCreator>>()
 const buttonsDisabled = ref(false)
 const visibleCount = ref(props.count)
 const visibleItemType = ref(props.itemType)
+const visibleMode = ref(props.mode)
+
+const formattedItemType = computed(() =>
+	formatContentTypeSentence(formatMessage, visibleItemType.value, visibleCount.value),
+)
+
+const admonitionHeader = computed(() =>
+	visibleMode.value === 'shared-instance'
+		? formatMessage(messages.sharedAdmonitionHeader)
+		: formatMessage(messages.admonitionHeader),
+)
+
+const admonitionBody = computed(() => {
+	if (visibleMode.value !== 'shared-instance') {
+		return formatMessage(messages.admonitionBody)
+	}
+
+	return visibleCount.value === 1
+		? formatMessage(messages.sharedSingleBody)
+		: formatMessage(messages.sharedBulkBody)
+})
+
+const deleteButtonLabel = computed(() => {
+	if (visibleMode.value !== 'shared-instance') {
+		return formatMessage(messages.deleteButton, {
+			count: visibleCount.value,
+			itemType: formattedItemType.value,
+		})
+	}
+
+	if (visibleCount.value === 1) {
+		return formatMessage(messages.sharedDeleteButton)
+	}
+
+	return formatMessage(messages.sharedDeleteManyButton, {
+		count: visibleCount.value,
+		itemType: formattedItemType.value,
+	})
+})
 
 async function show() {
 	await nextTick()
 	visibleCount.value = props.count
 	visibleItemType.value = props.itemType
+	visibleMode.value = props.mode
 	modal.value?.show()
 }
 
diff --git a/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmDisableModal.vue b/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmDisableModal.vue
new file mode 100644
index 0000000000..ca8ceb63d3
--- /dev/null
+++ b/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmDisableModal.vue
@@ -0,0 +1,134 @@
+<template>
+	<NewModal
+		ref="modal"
+		:header="
+			formatMessage(messages.header, {
+				itemType: formatContentTypeSentence(formatMessage, visibleItemType, visibleCount),
+			})
+		"
+		fade="warning"
+		max-width="500px"
+	>
+		<div class="flex flex-col gap-6">
+			<Admonition type="warning" :header="formatMessage(messages.admonitionHeader)">
+				{{
+					visibleCount === 1
+						? formatMessage(messages.singleBody)
+						: formatMessage(messages.bulkBody)
+				}}
+			</Admonition>
+		</div>
+
+		<template #actions>
+			<div class="flex gap-2 justify-end">
+				<ButtonStyled type="outlined">
+					<button @click="modal?.hide()">
+						<XIcon />
+						{{ formatMessage(commonMessages.cancelButton) }}
+					</button>
+				</ButtonStyled>
+				<ButtonStyled color="orange">
+					<button
+						v-tooltip="props.actionDisabled ? props.actionDisabledTooltip : undefined"
+						:disabled="props.actionDisabled"
+						@click="confirm"
+					>
+						<SlashIcon />
+						{{
+							visibleCount === 1
+								? formatMessage(messages.confirmButton)
+								: formatMessage(messages.confirmManyButton, {
+										count: visibleCount,
+										itemType: formatContentTypeSentence(
+											formatMessage,
+											visibleItemType,
+											visibleCount,
+										),
+									})
+						}}
+					</button>
+				</ButtonStyled>
+			</div>
+		</template>
+	</NewModal>
+</template>
+
+<script setup lang="ts">
+import { SlashIcon, XIcon } from '@modrinth/assets'
+import { nextTick, ref } from 'vue'
+
+import Admonition from '#ui/components/base/Admonition.vue'
+import ButtonStyled from '#ui/components/base/ButtonStyled.vue'
+import NewModal from '#ui/components/modal/NewModal.vue'
+import { defineMessages, useVIntl } from '#ui/composables/i18n'
+import { commonMessages, formatContentTypeSentence } from '#ui/utils/common-messages'
+
+const { formatMessage } = useVIntl()
+
+const messages = defineMessages({
+	header: {
+		id: 'content.confirm-disable.header',
+		defaultMessage: 'Disable {itemType}',
+	},
+	admonitionHeader: {
+		id: 'content.confirm-disable.shared-instance.admonition-header',
+		defaultMessage: 'This is part of the shared instance',
+	},
+	singleBody: {
+		id: 'content.confirm-disable.shared-instance.single-body',
+		defaultMessage:
+			'Disabling it only changes your local copy. Future shared instance updates may re-enable, restore, or change it again.',
+	},
+	bulkBody: {
+		id: 'content.confirm-disable.shared-instance.bulk-body',
+		defaultMessage:
+			'Some selected projects are part of the shared instance. Disabling them only changes your local copy, and future shared instance updates may re-enable, restore, or change them again.',
+	},
+	confirmButton: {
+		id: 'content.confirm-disable.shared-instance.confirm-button',
+		defaultMessage: 'Disable anyway',
+	},
+	confirmManyButton: {
+		id: 'content.confirm-disable.shared-instance.confirm-many-button',
+		defaultMessage: 'Disable {count, number} {itemType} anyway',
+	},
+})
+
+const props = withDefaults(
+	defineProps<{
+		count: number
+		itemType: string
+		actionDisabled?: boolean
+		actionDisabledTooltip?: string
+	}>(),
+	{
+		actionDisabled: false,
+		actionDisabledTooltip: undefined,
+	},
+)
+
+const emit = defineEmits<{
+	(e: 'disable'): void
+}>()
+
+const modal = ref<InstanceType<typeof NewModal>>()
+const visibleCount = ref(props.count)
+const visibleItemType = ref(props.itemType)
+
+async function show() {
+	await nextTick()
+	visibleCount.value = props.count
+	visibleItemType.value = props.itemType
+	modal.value?.show()
+}
+
+function confirm() {
+	if (props.actionDisabled) return
+	modal.value?.hide()
+	emit('disable')
+}
+
+defineExpose({
+	show,
+})
+</script>
diff --git a/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmUnlinkModal.vue b/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmUnlinkModal.vue
index 6d31307e43..0cfb52418b 100644
--- a/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmUnlinkModal.vue
+++ b/packages/ui/src/layouts/shared/content-tab/components/modals/ConfirmUnlinkModal.vue
@@ -1,14 +1,14 @@
 <template>
 	<NewModal
 		ref="modal"
-		:header="formatMessage(messages.header)"
+		:header="formatMessage(headerMessage)"
 		fade="warning"
 		max-width="500px"
 		:on-hide="() => backupCreator?.cancelBackup()"
 	>
 		<div class="flex flex-col gap-6">
-			<Admonition type="warning" :header="formatMessage(messages.admonitionHeader)">
-				{{ formatMessage(messages.admonitionBody) }}
+			<Admonition type="warning" :header="formatMessage(admonitionHeaderMessage)">
+				{{ formatMessage(admonitionBodyMessage) }}
 			</Admonition>
 			<InlineBackupCreator
 				ref="backupCreator"
@@ -32,7 +32,7 @@
 						@click="confirm"
 					>
 						<UnlinkIcon />
-						{{ formatMessage(props.server ? messages.header : messages.unlinkButton) }}
+						{{ formatMessage(actionMessage) }}
 					</button>
 				</ButtonStyled>
 			</div>
@@ -42,7 +42,7 @@
 
 <script setup lang="ts">
 import { UnlinkIcon, XIcon } from '@modrinth/assets'
-import { ref } from 'vue'
+import { computed, ref } from 'vue'
 
 import Admonition from '#ui/components/base/Admonition.vue'
 import ButtonStyled from '#ui/components/base/ButtonStyled.vue'
@@ -54,6 +54,7 @@ import { commonMessages } from '#ui/utils/common-messages'
 import InlineBackupCreator from './InlineBackupCreator.vue'
 
 const props = defineProps<{
+	mode?: 'default' | 'share-instance'
 	server?: boolean
 	backupTip?: string
 	actionDisabled?: boolean
@@ -77,6 +78,14 @@ const messages = defineMessages({
 		defaultMessage:
 			'Mods and content will be merged with what you added on top of the modpack, and it will stop receiving updates.',
 	},
+	shareInstanceAdmonitionHeader: {
+		id: 'content.confirm-unlink.share-instance-admonition-header',
+		defaultMessage: 'Sharing requires unlinking',
+	},
+	shareInstanceAdmonitionBody: {
+		id: 'content.confirm-unlink.share-instance-admonition-body',
+		defaultMessage: 'You must unlink this modpack to share your instance',
+	},
 	unlinkButton: {
 		id: 'content.confirm-unlink.unlink-button',
 		defaultMessage: 'Unlink',
@@ -90,6 +99,18 @@ const emit = defineEmits<{
 const modal = ref<InstanceType<typeof NewModal>>()
 const backupCreator = ref<InstanceType<typeof InlineBackupCreator>>()
 const buttonsDisabled = ref(false)
+const headerMessage = computed(() => messages.header)
+const admonitionHeaderMessage = computed(() =>
+	props.mode === 'share-instance'
+		? messages.shareInstanceAdmonitionHeader
+		: messages.admonitionHeader,
+)
+const admonitionBodyMessage = computed(() =>
+	props.mode === 'share-instance' ? messages.shareInstanceAdmonitionBody : messages.admonitionBody,
+)
+const actionMessage = computed(() =>
+	props.server && props.mode !== 'share-instance' ? messages.header : messages.unlinkButton,
+)
 
 function show() {
 	debug('show: called', {
diff --git a/packages/ui/src/layouts/shared/content-tab/index.ts b/packages/ui/src/layouts/shared/content-tab/index.ts
index 403e11aac9..13d1b9b6a7 100644
--- a/packages/ui/src/layouts/shared/content-tab/index.ts
+++ b/packages/ui/src/layouts/shared/content-tab/index.ts
@@ -4,6 +4,7 @@ export { default as ContentCardTable } from './components/ContentCardTable.vue'
 export { default as ContentModpackCard } from './components/ContentModpackCard.vue'
 export { default as ConfirmBulkUpdateModal } from './components/modals/ConfirmBulkUpdateModal.vue'
 export { default as ConfirmDeletionModal } from './components/modals/ConfirmDeletionModal.vue'
+export { default as ConfirmDisableModal } from './components/modals/ConfirmDisableModal.vue'
 export { default as ConfirmModpackUpdateModal } from './components/modals/ConfirmModpackUpdateModal.vue'
 export { default as ConfirmReinstallModal } from './components/modals/ConfirmReinstallModal.vue'
 export { default as ConfirmRepairModal } from './components/modals/ConfirmRepairModal.vue'
diff --git a/packages/ui/src/layouts/shared/content-tab/layout.vue b/packages/ui/src/layouts/shared/content-tab/layout.vue
index 8da41b4b74..085c967daf 100644
--- a/packages/ui/src/layouts/shared/content-tab/layout.vue
+++ b/packages/ui/src/layouts/shared/content-tab/layout.vue
@@ -33,6 +33,7 @@ import ContentModpackCard from './components/ContentModpackCard.vue'
 import ContentSelectionBar from './components/ContentSelectionBar.vue'
 import ConfirmBulkUpdateModal from './components/modals/ConfirmBulkUpdateModal.vue'
 import ConfirmDeletionModal from './components/modals/ConfirmDeletionModal.vue'
+import ConfirmDisableModal from './components/modals/ConfirmDisableModal.vue'
 import ConfirmUnlinkModal from './components/modals/ConfirmUnlinkModal.vue'
 import ContentDependencyWarningModal from './components/modals/ContentDependencyWarningModal.vue'
 import {
@@ -45,7 +46,12 @@ import {
 	useContentSelection,
 } from './composables'
 import { injectContentManager } from './providers/content-manager'
-import type { BulkOperationStatus, ContentCardTableItem, ContentItem } from './types'
+import type {
+	BulkOperationStatus,
+	ContentActionWarningMode,
+	ContentCardTableItem,
+	ContentItem,
+} from './types'
 
 const { formatMessage } = useVIntl()
 const debug = useDebugLogger('ContentPageLayout')
@@ -280,13 +286,14 @@ const tableItems = computed<ContentCardTableItem[]>(() => {
 			toggleDisabled: ctx.isBusy.value,
 			toggleDisabledTooltip: ctx.isBusy.value ? (ctx.busyMessage?.value ?? null) : null,
 			installing: item.installing === true,
-			hasUpdate: item.has_update,
+			hasUpdate: base.hasUpdate ?? item.has_update,
 			isClientOnly:
 				isClientOnlyEnvironment(item.environment) ||
 				!!item.pack_client_retained ||
 				!!item.pack_client_depends,
 			clientWarning: getClientWarningType(item),
-			hideSwitchVersion: !base.versionLink,
+			hideDelete: base.hideDelete,
+			hideSwitchVersion: base.hideSwitchVersion ?? !base.versionLink,
 			overflowOptions: ctx.getOverflowOptions?.(item),
 		}
 	})
@@ -322,8 +329,11 @@ const hasOutdatedProjects = computed(() => {
 
 //  Deletion
 const pendingDeletionItems = ref<ContentItem[]>([])
+const pendingDeletionWarningMode = ref<ContentActionWarningMode>('default')
 const confirmDeletionModal = ref<InstanceType<typeof ConfirmDeletionModal>>()
+const confirmDisableModal = ref<InstanceType<typeof ConfirmDisableModal>>()
 const contentDependencyWarningModal = ref<InstanceType<typeof ContentDependencyWarningModal>>()
+const pendingDisableItems = ref<ContentItem[]>([])
 const pendingDependencyWarningItems = ref<ContentCardTableItem[]>([])
 const pendingDependencyWarningDependents = ref<
 	Array<{
@@ -340,17 +350,25 @@ function mapToDisplayItem(item: ContentItem) {
 	}
 }
 
+function canDeleteItem(item: ContentItem) {
+	return ctx.canDeleteItem?.(item) ?? true
+}
+
+const deletableSelectedItems = computed(() => selectedItems.value.filter(canDeleteItem))
+
 async function promptDeleteItems(items: ContentItem[], event?: MouseEvent) {
-	if (items.length === 0) return
-	pendingDeletionItems.value = items
+	const deletableItems = items.filter(canDeleteItem)
+	if (deletableItems.length === 0) return
+	pendingDeletionItems.value = deletableItems
+	pendingDeletionWarningMode.value = ctx.getDeleteWarningMode?.(deletableItems) ?? 'default'
 	pendingDependencyWarningItems.value = []
 	pendingDependencyWarningDependents.value = []
 	pendingDependencyWarningDisableTargets.value = []
-	const deletingIds = new Set(items.map(getItemId))
+	const deletingIds = new Set(deletableItems.map(getItemId))
 
 	const warning = ctx.getDeleteDependencyWarning
 		? await Promise.resolve()
-				.then(() => ctx.getDeleteDependencyWarning!(items))
+				.then(() => ctx.getDeleteDependencyWarning!(deletableItems))
 				.catch(() => null)
 		: null
 	if (warning) {
@@ -366,7 +384,9 @@ async function promptDeleteItems(items: ContentItem[], event?: MouseEvent) {
 		const relevantDependencyIds = new Set(
 			remainingDependents.flatMap((dependent) => dependent.dependencies.map(getItemId)),
 		)
-		const warningItems = items.filter((item) => relevantDependencyIds.has(getItemId(item)))
+		const warningItems = deletableItems.filter((item) =>
+			relevantDependencyIds.has(getItemId(item)),
+		)
 		if (warningItems.length === 0) {
 			showDeletionConfirmation(event)
 			return
@@ -390,7 +410,11 @@ async function promptDeleteItems(items: ContentItem[], event?: MouseEvent) {
 }
 
 function showDeletionConfirmation(event?: MouseEvent) {
-	if ((event?.shiftKey || skipNonEssentialWarnings.value) && !ctx.isBusy.value) {
+	if (
+		pendingDeletionWarningMode.value === 'default' &&
+		(event?.shiftKey || skipNonEssentialWarnings.value) &&
+		!ctx.isBusy.value
+	) {
 		confirmDelete()
 	} else {
 		confirmDeletionModal.value?.show()
@@ -418,6 +442,11 @@ async function confirmDependencyWarningDelete(disableDependentsAfterDeleting: bo
 
 	pendingDependencyWarningItems.value = []
 	pendingDependencyWarningDependents.value = []
+	if (pendingDeletionWarningMode.value === 'shared-instance') {
+		confirmDeletionModal.value?.show()
+		return
+	}
+
 	await confirmDelete()
 }
 
@@ -426,6 +455,10 @@ async function disablePendingDependencyWarningDependents() {
 	pendingDependencyWarningDisableTargets.value = []
 	if (items.length === 0) return
 
+	await promptDisableItems(items)
+}
+
+async function disableItemsWithoutWarning(items: ContentItem[]) {
 	if (ctx.bulkDisableItems) {
 		await ctx.bulkDisableItems(items)
 		return
@@ -446,6 +479,7 @@ async function confirmDelete() {
 	if (ctx.isBusy.value) return
 	const itemsToDelete = [...pendingDeletionItems.value]
 	pendingDeletionItems.value = []
+	pendingDeletionWarningMode.value = 'default'
 	if (itemsToDelete.length === 0) return
 
 	if (ctx.bulkDeleteItems && itemsToDelete.length > 1) {
@@ -494,10 +528,72 @@ async function confirmDelete() {
 	await disablePendingDependencyWarningDependents()
 }
 
+async function promptDisableItems(items: ContentItem[]) {
+	if (items.length === 0) return
+	pendingDisableItems.value = items
+	const warningMode = ctx.getDisableWarningMode?.(items) ?? 'default'
+	if (warningMode === 'shared-instance') {
+		confirmDisableModal.value?.show()
+		return
+	}
+
+	await confirmDisable()
+}
+
+async function confirmDisable() {
+	if (ctx.isBusy.value) return
+	const itemsToDisable = [...pendingDisableItems.value]
+	pendingDisableItems.value = []
+	if (itemsToDisable.length === 0) return
+
+	if (ctx.bulkDisableItems && itemsToDisable.length > 1) {
+		isBulkOperating.value = true
+		bulkOperation.value = 'disable'
+		bulkProgress.value = 0
+		bulkTotal.value = itemsToDisable.length
+		bulkWaiting.value = true
+		try {
+			await disableItemsWithoutWarning(itemsToDisable)
+		} finally {
+			clearSelection()
+			isBulkOperating.value = false
+			bulkOperation.value = null
+			bulkProgress.value = 0
+			bulkTotal.value = 0
+			bulkWaiting.value = false
+		}
+		return
+	}
+
+	if (itemsToDisable.length === 1) {
+		const item = itemsToDisable[0]
+		const id = getItemId(item)
+		markChanging(id)
+		try {
+			if (ctx.bulkDisableItems) {
+				await ctx.bulkDisableItems(itemsToDisable)
+			} else {
+				await ctx.toggleEnabled(item)
+			}
+		} finally {
+			unmarkChanging(id)
+		}
+		return
+	}
+
+	await runBulk('disable', itemsToDisable, (item) => disableItemsWithoutWarning([item]), {
+		onComplete: clearSelection,
+	})
+}
+
 async function handleToggleEnabledById(id: string, _value: boolean) {
 	if (ctx.isBusy.value) return
 	const item = ctx.items.value.find((i) => getItemId(i) === id)
 	if (!item) return
+	if (!_value) {
+		await promptDisableItems([item])
+		return
+	}
 	markChanging(id)
 	try {
 		await ctx.toggleEnabled(item)
@@ -535,25 +631,7 @@ async function bulkDisable() {
 	if (ctx.isBusy.value) return
 	const items = selectedItems.value.filter((item) => item.enabled)
 	if (items.length === 0) return
-	if (ctx.bulkDisableItems) {
-		isBulkOperating.value = true
-		bulkOperation.value = 'disable'
-		bulkProgress.value = 0
-		bulkTotal.value = items.length
-		bulkWaiting.value = true
-		try {
-			await ctx.bulkDisableItems(items)
-		} finally {
-			clearSelection()
-			isBulkOperating.value = false
-			bulkOperation.value = null
-			bulkProgress.value = 0
-			bulkTotal.value = 0
-			bulkWaiting.value = false
-		}
-		return
-	}
-	await runBulk('disable', items, (item) => ctx.toggleEnabled(item), { onComplete: clearSelection })
+	await promptDisableItems(items)
 }
 
 function handleUpdateById(id: string) {
@@ -1012,9 +1090,10 @@ const confirmUnlinkModal = ref<InstanceType<typeof ConfirmUnlinkModal>>()
 			</template>
 
 			<template #actions-end>
-				<div class="mx-1 h-6 w-px bg-surface-5" />
+				<div v-if="deletableSelectedItems.length > 0" class="mx-1 h-6 w-px bg-surface-5" />
 
 				<ButtonStyled
+					v-if="deletableSelectedItems.length > 0"
 					type="transparent"
 					color="red"
 					color-fill="text"
@@ -1035,12 +1114,21 @@ const confirmUnlinkModal = ref<InstanceType<typeof ConfirmUnlinkModal>>()
 			ref="confirmDeletionModal"
 			:count="pendingDeletionItems.length"
 			:item-type="ctx.contentTypeLabel.value"
+			:mode="pendingDeletionWarningMode"
 			:variant="ctx.deletionContext ?? 'instance'"
 			:backup-tip="pendingDeletionItems.map((i) => i.project?.title ?? i.file_name).join(', ')"
 			:action-disabled="ctx.isBusy.value"
 			:action-disabled-tooltip="ctx.busyMessage?.value ?? undefined"
 			@delete="confirmDelete"
 		/>
+		<ConfirmDisableModal
+			ref="confirmDisableModal"
+			:count="pendingDisableItems.length"
+			:item-type="ctx.contentTypeLabel.value"
+			:action-disabled="ctx.isBusy.value"
+			:action-disabled-tooltip="ctx.busyMessage?.value ?? undefined"
+			@disable="confirmDisable"
+		/>
 		<ContentDependencyWarningModal
 			ref="contentDependencyWarningModal"
 			:items="pendingDependencyWarningItems"
diff --git a/packages/ui/src/layouts/shared/content-tab/providers/content-manager.ts b/packages/ui/src/layouts/shared/content-tab/providers/content-manager.ts
index ec92f4cb1b..88301f172f 100644
--- a/packages/ui/src/layouts/shared/content-tab/providers/content-manager.ts
+++ b/packages/ui/src/layouts/shared/content-tab/providers/content-manager.ts
@@ -6,6 +6,7 @@ import { createContext } from '#ui/providers/create-context'
 
 import type {
 	BulkOperationStatus,
+	ContentActionWarningMode,
 	ContentCardTableItem,
 	ContentItem,
 	ContentModpackCardCategory,
@@ -65,6 +66,9 @@ export interface ContentManagerContext {
 	bulkDeleteItems?: (items: ContentItem[]) => Promise<void>
 	bulkEnableItems?: (items: ContentItem[]) => Promise<void>
 	bulkDisableItems?: (items: ContentItem[]) => Promise<void>
+	canDeleteItem?: (item: ContentItem) => boolean
+	getDeleteWarningMode?: (items: ContentItem[]) => ContentActionWarningMode
+	getDisableWarningMode?: (items: ContentItem[]) => ContentActionWarningMode
 	getDeleteDependencyWarning?: (
 		items: ContentItem[],
 	) => ContentDependencyWarning | null | Promise<ContentDependencyWarning | null>
diff --git a/packages/ui/src/layouts/shared/content-tab/types.ts b/packages/ui/src/layouts/shared/content-tab/types.ts
index caf96bf687..0297add2aa 100644
--- a/packages/ui/src/layouts/shared/content-tab/types.ts
+++ b/packages/ui/src/layouts/shared/content-tab/types.ts
@@ -23,6 +23,16 @@ export interface ContentOwner {
 
 export type ClientWarningType = 'retained' | 'depends' | 'environment'
 
+export type ContentSourceKind =
+	| 'local'
+	| 'modrinth_modpack'
+	| 'server_project'
+	| 'modrinth_hosting'
+	| 'imported_modpack'
+	| 'shared_instance'
+
+export type ContentActionWarningMode = 'default' | 'shared-instance'
+
 export interface ContentCardTableItem {
 	id: string
 	project: ContentCardProject
@@ -39,6 +49,7 @@ export interface ContentCardTableItem {
 	hasUpdate?: boolean
 	isClientOnly?: boolean
 	clientWarning?: ClientWarningType | null
+	hideDelete?: boolean
 	hideSwitchVersion?: boolean
 	overflowOptions?: OverflowMenuOption[]
 }
@@ -70,6 +81,7 @@ export interface ContentItem extends Omit<
 	pack_client_retained?: boolean
 	pack_client_depends?: boolean
 	installing?: boolean
+	source_kind?: ContentSourceKind | null
 }
 
 export type ContentModpackCardProject = Pick<
diff --git a/packages/ui/src/locales/en-US/index.json b/packages/ui/src/locales/en-US/index.json
index 5b92b0577a..be1f3b425c 100644
--- a/packages/ui/src/locales/en-US/index.json
+++ b/packages/ui/src/locales/en-US/index.json
@@ -392,6 +392,12 @@
   "content.confirm-unlink.header": {
     "defaultMessage": "Unlink modpack"
   },
+  "content.confirm-unlink.share-instance-admonition-body": {
+    "defaultMessage": "You must unlink this modpack to share your instance"
+  },
+  "content.confirm-unlink.share-instance-admonition-header": {
+    "defaultMessage": "Sharing requires unlinking"
+  },
   "content.confirm-unlink.unlink-button": {
     "defaultMessage": "Unlink"
   },
@@ -4988,6 +4994,60 @@
   "settings.sessions.title": {
     "defaultMessage": "Sessions"
   },
+  "sharing.invite-players-modal.add": {
+    "defaultMessage": "Add"
+  },
+  "sharing.invite-players-modal.added": {
+    "defaultMessage": "Added"
+  },
+  "sharing.invite-players-modal.already-invited": {
+    "defaultMessage": "This user has already been invited."
+  },
+  "sharing.invite-players-modal.avatar-alt": {
+    "defaultMessage": "{username}'s avatar"
+  },
+  "sharing.invite-players-modal.cancel": {
+    "defaultMessage": "Cancel"
+  },
+  "sharing.invite-players-modal.friends-heading": {
+    "defaultMessage": "Your friends - {count}"
+  },
+  "sharing.invite-players-modal.invite": {
+    "defaultMessage": "Invite"
+  },
+  "sharing.invite-players-modal.invite-link-description": {
+    "defaultMessage": "This link invites your friends as players and automatically shares all required files!"
+  },
+  "sharing.invite-players-modal.invite-link-heading": {
+    "defaultMessage": "Or use an invite link"
+  },
+  "sharing.invite-players-modal.link-copied-text": {
+    "defaultMessage": "The invite link has been copied to your clipboard."
+  },
+  "sharing.invite-players-modal.link-copied-title": {
+    "defaultMessage": "Link copied"
+  },
+  "sharing.invite-players-modal.link-copy-failed-title": {
+    "defaultMessage": "Failed to copy link"
+  },
+  "sharing.invite-players-modal.no-friends": {
+    "defaultMessage": "No friends found."
+  },
+  "sharing.invite-players-modal.no-search-results": {
+    "defaultMessage": "No matching users found."
+  },
+  "sharing.invite-players-modal.requested": {
+    "defaultMessage": "Request sent"
+  },
+  "sharing.invite-players-modal.requested-tooltip": {
+    "defaultMessage": "{username} needs to accept your friend request first"
+  },
+  "sharing.invite-players-modal.search-placeholder": {
+    "defaultMessage": "Enter Modrinth username"
+  },
+  "sharing.invite-players-modal.searching": {
+    "defaultMessage": "Searching..."
+  },
   "tag.category.128x": {
     "defaultMessage": "128x"
   },
diff --git a/packages/ui/src/stories/notifications/NotificationToasts.stories.ts b/packages/ui/src/stories/notifications/NotificationToasts.stories.ts
index 61f5b0fb22..f33e941325 100644
--- a/packages/ui/src/stories/notifications/NotificationToasts.stories.ts
+++ b/packages/ui/src/stories/notifications/NotificationToasts.stories.ts
@@ -60,7 +60,6 @@ export const FigmaExamples: Story = {
 					actor-name="Fetch"
 					:actor-avatar-url="avatarUrl"
 					entity-name="New Creation"
-					:entity-icon-url="instanceIconUrl"
 					@accept="noop"
 					@decline="noop"
 					@dismiss="noop"
diff --git a/packages/ui/src/stories/sharing/InvitePlayersModal.stories.ts b/packages/ui/src/stories/sharing/InvitePlayersModal.stories.ts
new file mode 100644
index 0000000000..b184916138
--- /dev/null
+++ b/packages/ui/src/stories/sharing/InvitePlayersModal.stories.ts
@@ -0,0 +1,205 @@
+import type { Labrinth } from '@modrinth/api-client'
+import type { Meta, StoryObj } from '@storybook/vue3-vite'
+import { ref } from 'vue'
+
+import ButtonStyled from '../../components/base/ButtonStyled.vue'
+import InvitePlayersModal from '../../components/sharing/invite-players-modal/index.vue'
+import type {
+	InvitePlayersInvitePayload,
+	InvitePlayersUser,
+	InvitePlayersUserStatus,
+} from '../../components/sharing/invite-players-modal/types'
+
+const apiUsers: Labrinth.Users.v3.SearchUser[] = [
+	{
+		id: 'geometrically',
+		username: 'Geometrically',
+		avatar_url:
+			'https://cdn.modrinth.com/user/u6dRKJwZ/7ba3bdb11590a64843e9d2ab83ef85eaab42ec8e.png',
+	},
+	{
+		id: 'prospector',
+		username: 'Prospector',
+		avatar_url:
+			'https://cdn.modrinth.com/user/PHyAPGui/30a3a3f53866531831db4aa006794e6bbcfc4121.png',
+	},
+	{
+		id: 'fetch',
+		username: 'Fetch',
+		avatar_url:
+			'https://cdn.modrinth.com/user/yol4bNw3/ee2c7a7580ed475cfe3cfe8cc92df45ce33031e0.png',
+	},
+	{
+		id: 'imb11',
+		username: 'IMB11',
+		avatar_url: null,
+	},
+	{
+		id: 'josh',
+		username: 'Josh',
+		avatar_url: null,
+	},
+	{
+		id: 'emma',
+		username: 'Emma',
+		avatar_url: null,
+	},
+]
+
+const friendStatuses: Record<string, InvitePlayersUserStatus> = {
+	geometrically: 'added',
+	fetch: 'pending',
+}
+
+const meta = {
+	title: 'Sharing/InvitePlayersModal',
+	component: InvitePlayersModal,
+	parameters: {
+		layout: 'centered',
+		docs: {
+			description: {
+				component:
+					'Invite players modal for app instance sharing and server player invites. Callers provide the user search proxy and own invite/cancel persistence.',
+			},
+		},
+	},
+} satisfies Meta<typeof InvitePlayersModal>
+
+export default meta
+type Story = StoryObj<typeof meta>
+
+function toInviteUser(
+	user: Labrinth.Users.v3.SearchUser,
+	status: InvitePlayersUserStatus = 'available',
+): InvitePlayersUser {
+	return {
+		id: user.id,
+		username: user.username,
+		avatarUrl: user.avatar_url,
+		status,
+		online: user.id === 'prospector',
+	}
+}
+
+function createFriends() {
+	return apiUsers
+		.slice(0, 4)
+		.map((user) => toInviteUser(user, friendStatuses[user.id] ?? 'available'))
+}
+
+function createSearchUsers() {
+	return apiUsers.map((user) => ({
+		id: user.id,
+		username: user.username,
+		avatarUrl: user.avatar_url,
+	}))
+}
+
+function createRender(args: Record<string, unknown>) {
+	return {
+		components: { ButtonStyled, InvitePlayersModal },
+		setup() {
+			const modalRef = ref<InstanceType<typeof InvitePlayersModal> | null>(null)
+			const friends = ref<InvitePlayersUser[]>(createFriends())
+			const searchUsers = createSearchUsers()
+			const lastAction = ref('')
+			const manuallyAddedFriendIds = ref(new Set<string>())
+
+			async function searchInviteUsers(query: string) {
+				await new Promise((resolve) => setTimeout(resolve, 250))
+				const normalizedQuery = query.trim().toLowerCase()
+				const friendKeys = new Set(
+					friends.value.flatMap((friend) => [
+						friend.id.toLowerCase(),
+						friend.username.toLowerCase(),
+					]),
+				)
+
+				return searchUsers.filter(
+					(user) =>
+						user.username.toLowerCase().startsWith(normalizedQuery) &&
+						!friendKeys.has(user.id.toLowerCase()) &&
+						!friendKeys.has(user.username.toLowerCase()),
+				)
+			}
+
+			function handleInvite(payload: InvitePlayersInvitePayload) {
+				const existingFriend = friends.value.find((friend) => friend.id === payload.user.id)
+
+				if (payload.source === 'search') {
+					if (existingFriend) {
+						existingFriend.status = 'requested'
+					} else {
+						friends.value = [{ ...payload.user, status: 'requested' }, ...friends.value]
+					}
+
+					manuallyAddedFriendIds.value = new Set([...manuallyAddedFriendIds.value, payload.user.id])
+					lastAction.value = `Sent friend request to ${payload.user.username}`
+					return
+				}
+
+				if (existingFriend) {
+					existingFriend.status = 'pending'
+				}
+
+				lastAction.value = `Invited ${payload.user.username} from ${payload.source}`
+			}
+
+			function handleCancel(user: InvitePlayersUser) {
+				const existingFriend = friends.value.find((friend) => friend.id === user.id)
+				if (manuallyAddedFriendIds.value.has(user.id)) {
+					friends.value = friends.value.filter((friend) => friend.id !== user.id)
+					const nextManuallyAddedFriendIds = new Set(manuallyAddedFriendIds.value)
+					nextManuallyAddedFriendIds.delete(user.id)
+					manuallyAddedFriendIds.value = nextManuallyAddedFriendIds
+					lastAction.value = `Cancelled friend request for ${user.username}`
+					return
+				}
+
+				if (existingFriend) existingFriend.status = 'available'
+				lastAction.value = `Cancelled invite for ${user.username}`
+			}
+
+			return {
+				args,
+				friends,
+				handleCancel,
+				handleInvite,
+				lastAction,
+				modalRef,
+				searchInviteUsers,
+			}
+		},
+		template: /* html */ `
+			<div class="flex flex-col items-center gap-4">
+				<ButtonStyled color="brand">
+					<button @click="modalRef?.show($event)">Open modal</button>
+				</ButtonStyled>
+				<p v-if="lastAction" class="m-0 text-sm text-secondary">{{ lastAction }}</p>
+				<InvitePlayersModal
+					ref="modalRef"
+					v-bind="args"
+					:friends="friends"
+					:search-users="searchInviteUsers"
+					@invite="handleInvite"
+					@cancel="handleCancel"
+				/>
+			</div>
+		`,
+	}
+}
+
+export const ShareInstance: Story = {
+	args: {
+		header: 'Share instance',
+		link: 'https://modrinth.com/instance/abc123',
+	},
+	render: (args) => createRender(args),
+}
+
+export const FriendsOnly: Story = {
+	args: {
+		header: 'Invite players',
+	},
+	render: (args) => createRender(args),
+}
diff --git a/standards/frontend/COMPONENT_STRUCTURE.md b/standards/frontend/COMPONENT_STRUCTURE.md
new file mode 100644
index 0000000000..99cfeb3837
--- /dev/null
+++ b/standards/frontend/COMPONENT_STRUCTURE.md
@@ -0,0 +1,128 @@
+# Component Structure
+
+## Component folders
+
+Prefer giving non-trivial components their own folder:
+
+```
+components/
+└── analytics-chart/
+	├── index.vue
+	├── analytics-chart-header.vue
+	├── analytics-chart-plot.vue
+	├── analytics-chart-data.ts
+	└── use-analytics-chart.ts
+```
+
+The folder name should match the public component name in kebab case. The main component in that folder should be `index.vue`.
+
+This keeps imports short:
+
+```ts
+import AnalyticsChart from '@/components/analytics-chart/index.vue'
+```
+
+If the local resolver supports directory indexes, importing the folder is also fine:
+
+```ts
+import AnalyticsChart from '@/components/analytics-chart/'
+```
+
+Use the explicit `index.vue` import when the TypeScript setup cannot resolve the directory import reliably.
+
+## Local implementation files
+
+Keep files that only exist to support one component inside that component's folder:
+
+```
+analytics-chart/
+├── index.vue
+├── analytics-chart-header.vue
+├── analytics-chart-plot.vue
+├── analytics-chart-tooltip.vue
+├── chart-ranges.ts
+└── use-chart-hover-state.ts
+```
+
+Good candidates for local files:
+
+- Small subcomponents used only by the main component
+- Local composables used only by the main component or its local subcomponents
+- Helpers that split up a large `<script setup>` block
+- Types that describe local component state or props
+
+This is preferred over allowing a single component file to grow into a large, hard-to-review script block.
+
+## Naming local subcomponents
+
+Local subcomponents should still have clear names that explain their relationship to the main component:
+
+```
+analytics-chart/
+├── index.vue
+├── analytics-chart-header.vue
+└── analytics-chart-plot.vue
+```
+
+Avoid vague names that make a local component look like a standalone public component:
+
+```
+analytics-chart/
+├── index.vue
+├── events.vue
+└── header.vue
+```
+
+If a file is local to `analytics-chart`, prefixing it with `analytics-chart-` makes that relationship clear when it appears in search results, editor tabs, and imports.
+
+## Nesting
+
+One level of nesting is usually enough.
+
+Prefer this:
+
+```
+analytics-chart/
+├── index.vue
+├── analytics-chart-header.vue
+├── analytics-chart-plot.vue
+├── use-chart-hover-state.ts
+└── use-chart-selection.ts
+```
+
+Avoid this unless a local area has become large enough to justify its own module boundary:
+
+```
+analytics-chart/
+├── index.vue
+├── header/
+│	└── index.vue
+└── plot/
+	├── index.vue
+	└── use-plot-state.ts
+```
+
+Subfolders are fine when they reduce real complexity, but do not create a folder for every small subcomponent by default. Deep nesting makes the file tree harder to scan and often adds duplicated names without improving ownership.
+
+## When not to use a folder
+
+Small, leaf components can stay as a single `.vue` file:
+
+```
+components/
+├── avatar-stack.vue
+├── empty-state.vue
+└── project-status-pill.vue
+```
+
+Move a component into a folder once it grows local helpers, local composables, or local subcomponents.
+
+## Public versus local components
+
+Only the main `index.vue` should be treated as the public entry point for the folder. Other files in the folder are implementation details unless there is a clear reason to import them from outside.
+
+If a local subcomponent starts being imported elsewhere, either:
+
+- Promote it into its own component folder
+- Move it to the nearest shared component area if it is genuinely reusable
+- Keep it local and pass behavior through the main component if external imports would leak implementation details